Providers
Qianfan
Qianfan, Baidu'nun MaaS platformudur; istekleri tek bir endpoint ve API anahtarı arkasındaki birçok modele yönlendiren birleşik bir API sağlar. OpenAI uyumludur, bu nedenle çoğu OpenAI SDK'sı temel URL değiştirilerek çalışır.
| Özellik | Değer |
|---|---|
| Sağlayıcı | qianfan |
| Kimlik doğrulama | QIANFAN_API_KEY |
| API | OpenAI uyumlu |
| Temel URL | https://qianfan.baidubce.com/v2 |
Plugin kur
Resmi Plugin'i kurun, ardından Gateway'i yeniden başlatın:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartBaşlarken
Baidu Cloud hesabı oluşturun
Qianfan Console üzerinden kaydolun veya oturum açın ve Qianfan API erişiminizin etkin olduğundan emin olun.
API anahtarı oluşturun
Yeni bir uygulama oluşturun veya mevcut bir uygulamayı seçin, ardından bir API anahtarı oluşturun. Anahtar biçimi bce-v3/ALTAK-... şeklindedir.
Onboarding çalıştırın
openclaw onboard --auth-choice qianfan-api-keyModelin kullanılabilir olduğunu doğrulayın
openclaw models list --provider qianfanYerleşik katalog
| Model ref | Girdi | Bağlam | En fazla çıktı | Akıl yürütme | Notlar |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
metin | 98,304 | 32,768 | Evet | Varsayılan model |
qianfan/ernie-5.0-thinking-preview |
metin, görüntü | 119,000 | 64,000 | Evet | Çok modlu |
Yapılandırma örneği
{ 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, }, ], }, }, },}Taşıma ve uyumluluk
Qianfan, yerel OpenAI istek şekillendirmesi yerine OpenAI uyumlu taşıma yolu üzerinden çalışır. Bu, standart OpenAI SDK özelliklerinin çalıştığı, ancak sağlayıcıya özgü parametrelerin iletilmeyebileceği anlamına gelir.
Katalog ve geçersiz kılmalar
Statik katalog şu anda deepseek-v3.2 ve ernie-5.0-thinking-preview içerir. models.providers.qianfan değerini yalnızca özel bir temel URL veya model meta verisi gerektiğinde ekleyin ya da geçersiz kılın.
Sorun giderme
- API anahtarınızın
bce-v3/ALTAK-ile başladığından ve Baidu Cloud konsolunda Qianfan API erişiminin etkin olduğundan emin olun. - Modeller listelenmiyorsa hesabınızda Qianfan hizmetinin etkinleştirildiğini doğrulayın.
- Varsayılan temel URL
https://qianfan.baidubce.com/v2şeklindedir. Bunu yalnızca özel bir endpoint veya proxy kullanıyorsanız değiştirin.
