本页内容
本页内容
供应商
Qianfan
Qianfan 是 Baidu 的 MaaS 平台:一个统一的、与 OpenAI- 兼容的 API,可将请求路由到单个端点和 API 密钥后面的多个模型。 OpenClaw 将其作为官方外部插件 @openclaw/qianfan-provider 提供。
| 属性 | 值 |
|---|---|
| 提供者 | qianfan |
| 认证 | QIANFAN_API_KEY |
| API | OpenAI-兼容(openai-completions) |
| 基础 URL | https://qianfan.baidubce.com/v2 |
| 默认模型 | qianfan/deepseek-v4-pro |
安装插件
安装官方插件:
安装自动应用于正在运行的网关;否则下次启动时生效。请参阅 应用更改并检查 。
入门
创建Baidu云账号
在千帆Console上注册或登录并启用Qianfan API访问。
生成 API 密钥
创建一个新应用程序或选择现有应用程序,然后生成 API 密钥。 Baidu 云密钥使用 bce-v3/ALTAK-... 格式。
运行入门引导培训
非交互式运行会从 --qianfan-api-key <key> 或 QIANFAN_API_KEY 读取密钥。引导流程会写入提供商配置,为默认模型添加 QIANFAN 别名,并在未配置默认模型时将 qianfan/deepseek-v4-pro 设置为默认模型。
验证模型是否可用
内置目录
| 模型引用 | 输入 | 上下文 | 最大输出 | 推理 | 笔记 |
|---|---|---|---|---|---|
qianfan/deepseek-v4-pro |
文本 | 1,000,000 | 393,216 | 是 | 当前 DeepSeek 旗舰模型 |
qianfan/ernie-5.1 |
文本 | 128,000 | 65,536 | No | 最新 ERNIE 文本旗舰模型 |
qianfan/ernie-5.0 |
文本、图像 | 128,000 | 65,536 | 是 | 当前多模态和思考模型 |
qianfan/deepseek-v3.2 |
文本 | 128,000 | 32,768 | No | 已弃用的接入兼容性默认模型;由 deepseek-v4-pro 替代 |
qianfan/ernie-5.0-thinking-preview |
文本、图像 | 128,000 | 65,536 | 是 | 已弃用的别名;由 ernie-5.0 替代 |
目录是静态的;没有实时模型发现。
安装程序会保存连接设置和别名,而无需将生成的目录行复制到您的配置中。显式 models.mode: "replace" 保持目录播种启用;自定义模型行保持不变。
配置示例
此示例明确选择当前的 DeepSeek 旗舰产品,这也是默认设置的模型。
运输和兼容性
Qianfan 通过 OpenAI- 兼容传输路径运行,而不是本机 OpenAI 请求整形。标准 OpenAI SDK 功能有效,但可能无法转发提供商特定的参数。
故障排查
- 检查您的 API 密钥是否以
bce-v3/ALTAK-开头,并且在 Baidu 云控制台中启用了 Qianfan API 访问权限。 - 如果未列出模型,请确认你的账户已激活 Qianfan 服务。
- 只有在使用自定义端点或代理时才更改基础 URL。
相关内容
本页有帮助吗?