Providers
Qianfan
Qianfan เป็นแพลตฟอร์ม MaaS ของ Baidu ที่ให้ API แบบรวมศูนย์ ซึ่งส่งคำขอไปยังหลายโมเดลเบื้องหลัง endpoint และ API key เดียว แพลตฟอร์มนี้เข้ากันได้กับ OpenAI ดังนั้น OpenAI SDK ส่วนใหญ่จึงใช้งานได้โดยเปลี่ยน base URL
| คุณสมบัติ | ค่า |
|---|---|
| Provider | qianfan |
| Auth | 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 และตรวจสอบให้แน่ใจว่าคุณเปิดใช้งานการเข้าถึง Qianfan API แล้ว
Generate an API key
สร้างแอปพลิเคชันใหม่หรือเลือกแอปพลิเคชันที่มีอยู่ จากนั้นสร้าง API key รูปแบบคีย์คือ 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 ทำงานผ่านเส้นทาง transport ที่เข้ากันได้กับ OpenAI ไม่ใช่การจัดรูปแบบคำขอแบบ OpenAI โดยตรง ซึ่งหมายความว่าฟีเจอร์มาตรฐานของ OpenAI SDK ใช้งานได้ แต่พารามิเตอร์เฉพาะของ Provider อาจไม่ถูกส่งต่อ
Catalog and overrides
แค็ตตาล็อกแบบคงที่ในปัจจุบันมี deepseek-v3.2 และ ernie-5.0-thinking-preview เพิ่มหรือแทนที่ models.providers.qianfan เฉพาะเมื่อคุณต้องการ base URL แบบกำหนดเองหรือ metadata ของโมเดล
Troubleshooting
- ตรวจสอบให้แน่ใจว่า API key ของคุณขึ้นต้นด้วย
bce-v3/ALTAK-และเปิดใช้งานการเข้าถึง Qianfan API ในคอนโซล Baidu Cloud แล้ว - หากไม่แสดงรายการโมเดล ให้ยืนยันว่าบัญชีของคุณเปิดใช้งานบริการ Qianfan แล้ว
- base URL เริ่มต้นคือ
https://qianfan.baidubce.com/v2เปลี่ยนเฉพาะเมื่อคุณใช้ endpoint หรือพร็อกซีแบบกำหนดเอง
