Chuyển đến nội dung chính
Qianfan là nền tảng MaaS của Baidu, cung cấp một API hợp nhất định tuyến yêu cầu đến nhiều mô hình phía sau một endpoint và khóa API duy nhất. Nền tảng này tương thích với OpenAI, nên hầu hết các SDK OpenAI đều hoạt động bằng cách đổi URL cơ sở.
Thuộc tínhGiá trị
Nhà cung cấpqianfan
Xác thựcQIANFAN_API_KEY
APITương thích với OpenAI
URL cơ sởhttps://qianfan.baidubce.com/v2

​
Cài đặt Plugin

Cài đặt Plugin chính thức, rồi khởi động lại Gateway: 
openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

​
Bắt đầu

1

Create a Baidu Cloud account

Đăng ký hoặc đăng nhập tại Qianfan Console và đảm bảo bạn đã bật quyền truy cập API Qianfan.
2

Generate an API key

Tạo một ứng dụng mới hoặc chọn một ứng dụng hiện có, rồi tạo khóa API. Định dạng khóa là bce-v3/ALTAK-....
3

Run onboarding

openclaw onboard --auth-choice qianfan-api-key
4

Verify the model is available

openclaw models list --provider qianfan

​
Danh mục tích hợp sẵn

Tham chiếu mô hìnhĐầu vàoNgữ cảnhĐầu ra tối đaSuy luậnGhi chú
qianfan/deepseek-v3.2văn bản98,30432,768CóMô hình mặc định
qianfan/ernie-5.0-thinking-previewvăn bản, hình ảnh119,00064,000CóĐa phương thức
Tham chiếu mô hình mặc định là qianfan/deepseek-v3.2. Bạn chỉ cần ghi đè models.providers.qianfan khi cần URL cơ sở tùy chỉnh hoặc siêu dữ liệu mô hình.

​
Ví dụ cấu hình

{
  env: { QIANFAN_API_KEY: "bce-v3/ALTAK-..." },
  agents: {
    defaults: {
      model: { primary: "qianfan/deepseek-v3.2" },
      models: {
        "qianfan/deepseek-v3.2": { alias: "QIANFAN" },
      },
    },
  },
  models: {
    providers: {
      qianfan: {
        baseUrl: "https://qianfan.baidubce.com/v2",
        api: "openai-completions",
        models: [
          {
            id: "deepseek-v3.2",
            name: "DEEPSEEK V3.2",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 98304,
            maxTokens: 32768,
          },
          {
            id: "ernie-5.0-thinking-preview",
            name: "ERNIE-5.0-Thinking-Preview",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 119000,
            maxTokens: 64000,
          },
        ],
      },
    },
  },
}
Qianfan chạy qua đường dẫn truyền tải tương thích với OpenAI, không phải cơ chế định hình yêu cầu OpenAI gốc. Điều này có nghĩa là các tính năng SDK OpenAI tiêu chuẩn hoạt động, nhưng các tham số riêng của nhà cung cấp có thể không được chuyển tiếp.
Danh mục tĩnh hiện bao gồm deepseek-v3.2 và ernie-5.0-thinking-preview. Chỉ thêm hoặc ghi đè models.providers.qianfan khi bạn cần URL cơ sở tùy chỉnh hoặc siêu dữ liệu mô hình.
Tham chiếu mô hình dùng tiền tố qianfan/ (ví dụ qianfan/deepseek-v3.2).
  • Đảm bảo khóa API của bạn bắt đầu bằng bce-v3/ALTAK- và đã bật quyền truy cập API Qianfan trong bảng điều khiển Baidu Cloud.
  • Nếu các mô hình không được liệt kê, hãy xác nhận tài khoản của bạn đã kích hoạt dịch vụ Qianfan.
  • URL cơ sở mặc định là https://qianfan.baidubce.com/v2. Chỉ thay đổi URL này nếu bạn dùng endpoint hoặc proxy tùy chỉnh.

​
Liên quan

Model selection

Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.

Configuration reference

Tài liệu tham chiếu cấu hình OpenClaw đầy đủ.

Agent setup

Cấu hình mặc định cho agent và gán mô hình.

Qianfan API docs

Tài liệu API Qianfan chính thức.