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 コンソールで登録またはログインし、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?
