提供商
千帆
Qianfan 是百度的 MaaS 平台，提供一个统一 API，可通过单一端点和 API key 将请求路由到多个模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换 base URL 即可使用。
| 属性 | 值 |
|---|---|
| 提供商 | qianfan |
| 身份验证 | QIANFAN_API_KEY |
| API | 兼容 OpenAI |
| 基础 URL | https://qianfan.baidubce.com/v2 |
入门指南
创建百度云账号
在 Qianfan Console 注册或登录，并确保已启用 Qianfan API 访问权限。
生成 API key
创建新应用或选择现有应用，然后生成 API key。密钥格式为 bce-v3/ALTAK-...。
运行新手引导
openclaw onboard --auth-choice qianfan-api-key
验证模型是否可用
openclaw models list --provider qianfan
内置目录
| 模型引用 | 输入 | 上下文 | 最大输出 | 推理 | 备注 |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
text | 98,304 | 32,768 | 是 | 默认模型 |
qianfan/ernie-5.0-thinking-preview |
text, image | 119,000 | 64,000 | 是 | 多模态 |
配置示例
{
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 通过 OpenAI 兼容的传输路径运行，而不是原生 OpenAI 请求构造。这意味着标准 OpenAI SDK 功能可以使用，但提供商特定参数可能不会被转发。
目录和覆盖
当前内置目录包含 deepseek-v3.2 和 ernie-5.0-thinking-preview。只有在需要自定义 base URL 或模型元数据时，才添加或覆盖 models.providers.qianfan。
故障排除
- 确保你的 API key 以
bce-v3/ALTAK-开头，并且已在百度云控制台启用 Qianfan API 访问权限。 - 如果未列出模型，请确认你的账号已激活 Qianfan 服务。
- 默认 base URL 是
https://qianfan.baidubce.com/v2。仅在使用自定义端点或代理时才更改它。