Providers
Qianfan
Qianfan پلتفرم MaaS شرکت Baidu است که یک API یکپارچه ارائه میدهد و درخواستها را پشت یک endpoint و کلید API واحد به مدلهای متعدد هدایت میکند. این پلتفرم با OpenAI سازگار است، بنابراین بیشتر SDKهای OpenAI با تغییر base URL کار میکنند.
| ویژگی | مقدار |
|---|---|
| ارائهدهنده | qianfan |
| احراز هویت | QIANFAN_API_KEY |
| API | سازگار با OpenAI |
| Base URL | https://qianfan.baidubce.com/v2 |
نصب Plugin
Plugin رسمی را نصب کنید، سپس Gateway را راهاندازی مجدد کنید:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartشروع به کار
Create a Baidu Cloud account
در Qianfan Console ثبتنام کنید یا وارد شوید و مطمئن شوید دسترسی API Qianfan برای شما فعال است.
Generate an API key
یک برنامه جدید ایجاد کنید یا یکی از برنامههای موجود را انتخاب کنید، سپس یک کلید API بسازید. قالب کلید bce-v3/ALTAK-... است.
Run onboarding
openclaw onboard --auth-choice qianfan-api-keyVerify the model is available
openclaw models list --provider qianfanکاتالوگ داخلی
| Model ref | ورودی | زمینه | حداکثر خروجی | استدلال | یادداشتها |
|---|---|---|---|---|---|
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, }, ], }, }, },}Transport and compatibility
Qianfan از مسیر انتقال سازگار با OpenAI اجرا میشود، نه از شکلدهی درخواست بومی OpenAI. این یعنی قابلیتهای استاندارد SDKهای OpenAI کار میکنند، اما ممکن است پارامترهای اختصاصی ارائهدهنده ارسال نشوند.
Catalog and overrides
کاتالوگ ایستا در حال حاضر شامل deepseek-v3.2 و ernie-5.0-thinking-preview است. فقط زمانی models.providers.qianfan را اضافه یا بازنویسی کنید که به base URL سفارشی یا فراداده مدل نیاز داشته باشید.
Troubleshooting
- مطمئن شوید کلید API شما با
bce-v3/ALTAK-شروع میشود و دسترسی API Qianfan در کنسول Baidu Cloud فعال است. - اگر مدلها فهرست نمیشوند، تأیید کنید که سرویس Qianfan برای حساب شما فعال شده است.
- Base URL پیشفرض
https://qianfan.baidubce.com/v2است. فقط در صورتی آن را تغییر دهید که از endpoint یا proxy سفارشی استفاده میکنید.
