Providers
Qianfan
Qianfan adalah platform MaaS Baidu, yang menyediakan API terpadu yang merutekan permintaan ke banyak model di balik satu endpoint dan kunci API. Platform ini kompatibel dengan OpenAI, sehingga sebagian besar SDK OpenAI berfungsi dengan mengganti URL dasar.
| Properti | Nilai |
|---|---|
| Penyedia | qianfan |
| Auth | QIANFAN_API_KEY |
| API | Kompatibel dengan OpenAI |
| URL dasar | https://qianfan.baidubce.com/v2 |
Instal Plugin
Instal Plugin resmi, lalu mulai ulang Gateway:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartMemulai
Buat akun Baidu Cloud
Daftar atau masuk di Konsol Qianfan dan pastikan akses API Qianfan telah diaktifkan.
Buat kunci API
Buat aplikasi baru atau pilih aplikasi yang sudah ada, lalu buat kunci API. Format kuncinya adalah bce-v3/ALTAK-....
Jalankan onboarding
openclaw onboard --auth-choice qianfan-api-keyVerifikasi bahwa model tersedia
openclaw models list --provider qianfanKatalog bawaan
| Ref model | Masukan | Konteks | Output maksimum | Penalaran | Catatan |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
teks | 98,304 | 32,768 | Ya | Model default |
qianfan/ernie-5.0-thinking-preview |
teks, gambar | 119,000 | 64,000 | Ya | Multimodal |
Contoh konfigurasi
{ 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 dan kompatibilitas
Qianfan berjalan melalui jalur transport yang kompatibel dengan OpenAI, bukan pembentukan permintaan OpenAI native. Ini berarti fitur SDK OpenAI standar berfungsi, tetapi parameter khusus penyedia mungkin tidak diteruskan.
Katalog dan penggantian
Katalog statis saat ini mencakup deepseek-v3.2 dan ernie-5.0-thinking-preview. Tambahkan atau ganti models.providers.qianfan hanya saat Anda memerlukan URL dasar khusus atau metadata model.
Pemecahan masalah
- Pastikan kunci API Anda dimulai dengan
bce-v3/ALTAK-dan akses API Qianfan telah diaktifkan di konsol Baidu Cloud. - Jika model tidak tercantum, konfirmasikan bahwa layanan Qianfan telah diaktifkan untuk akun Anda.
- URL dasar default adalah
https://qianfan.baidubce.com/v2. Ubah hanya jika Anda menggunakan endpoint atau proxy khusus.
