Providers
Qianfan
Qianfan は Baidu の MaaS プラットフォームです。単一のエンドポイントと API キーを使用して、多数のモデルにリクエストを振り分ける、統合された OpenAI 互換 API です。OpenClaw では、公式の外部 Plugin @openclaw/qianfan-provider として提供されています。
| プロパティ | 値 |
|---|---|
| プロバイダー | qianfan |
| 認証 | QIANFAN_API_KEY |
| API | OpenAI 互換（openai-completions） |
| ベース URL | https://qianfan.baidubce.com/v2 |
| デフォルトモデル | qianfan/deepseek-v3.2 |
Plugin のインストール
公式 Plugin をインストールしてから、Gateway を再起動します。
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartはじめに
Baidu Cloud アカウントを作成する
Qianfan Console で新規登録またはログインし、Qianfan API へのアクセスが有効になっていることを確認します。
API キーを生成する
新しいアプリケーションを作成するか既存のアプリケーションを選択し、API キーを生成します。Baidu Cloud のキーでは bce-v3/ALTAK-... 形式を使用します。
オンボーディングを実行する
openclaw onboard --auth-choice qianfan-api-key非対話型の実行では、--qianfan-api-key <key> または
QIANFAN_API_KEY からキーを読み取ります。オンボーディングはプロバイダー設定を書き込み、
デフォルトモデルに QIANFAN エイリアスを追加し、モデルが設定されていない場合は
qianfan/deepseek-v3.2 をデフォルトモデルに設定します。
モデルが利用可能であることを確認する
openclaw models list --provider qianfan組み込みカタログ
| モデル参照 | 入力 | コンテキスト | 最大出力 | 推論 | 備考 |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
テキスト | 98,304 | 32,768 | あり | デフォルトモデル |
qianfan/ernie-5.0-thinking-preview |
テキスト、画像 | 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 機能は動作しますが、プロバイダー固有のパラメーターは転送されない場合があります。
トラブルシューティング
- API キーが
bce-v3/ALTAK-で始まり、Baidu Cloud コンソールで Qianfan API へのアクセスが有効になっていることを確認します。 - モデルが一覧に表示されない場合は、アカウントで Qianfan サービスが有効化されていることを確認します。
- カスタムエンドポイントまたはプロキシを使用する場合にのみ、ベース URL を変更してください。
関連項目
Was this useful?
