Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 OpenAI SDK hoạt động bằng cách chuyển đổi base URL.
Thuộc tínhGiá trị
Nhà cung cấpqianfan
Xác thựcQIANFAN_API_KEY
APITương thích với OpenAI
Base URLhttps://qianfan.baidubce.com/v2

​
Bắt đầu

1

Tạo tài khoản Baidu Cloud

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

Tạo khóa API

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

Chạy quy trình onboarding

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

Xác minh mô hình có sẵn

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 tích hợp mặc định là qianfan/deepseek-v3.2. Bạn chỉ cần ghi đè models.providers.qianfan khi cần base URL tùy chỉnh hoặc metadata 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 truyền tải tương thích với OpenAI, không phải định dạng yêu cầu OpenAI gốc. Điều này nghĩa là các tính năng OpenAI SDK tiêu chuẩn hoạt động, nhưng tham số dành riêng cho nhà cung cấp có thể không được chuyển tiếp.
Danh mục tích hợp 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 base URL tùy chỉnh hoặc metadata mô hình.
Tham chiếu mô hình sử 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 Qianfan API trong bảng điều khiển Baidu Cloud.
  • Nếu 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.
  • Base URL mặc định là https://qianfan.baidubce.com/v2. Chỉ thay đổi nếu bạn dùng endpoint hoặc proxy tùy chỉnh.

​
Liên quan

Lựa chọn mô hình

Chọn nhà cung cấp, tham chiếu mô hình và hành vi failover.

Tham chiếu cấu hình

Tham chiếu cấu hình OpenClaw đầy đủ.

Thiết lập agent

Cấu hình mặc định của agent và việc gán mô hình.

Tài liệu Qianfan API

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