Providers
Qianfan
Qianfan è la piattaforma MaaS di Baidu, che fornisce un'API unificata che instrada le richieste a molti modelli dietro un singolo endpoint e una chiave API. È compatibile con OpenAI, quindi la maggior parte degli SDK OpenAI funziona cambiando l'URL di base.
| Proprietà | Valore |
|---|---|
| Provider | qianfan |
| Autenticazione | QIANFAN_API_KEY |
| API | Compatibile con OpenAI |
| URL di base | https://qianfan.baidubce.com/v2 |
Installa il plugin
Installa il plugin ufficiale, quindi riavvia Gateway:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartPer iniziare
Create a Baidu Cloud account
Registrati o accedi alla Console Qianfan e assicurati di avere l'accesso all'API Qianfan abilitato.
Generate an API key
Crea una nuova applicazione o selezionane una esistente, quindi genera una chiave API. Il formato della chiave è bce-v3/ALTAK-....
Run onboarding
openclaw onboard --auth-choice qianfan-api-keyVerify the model is available
openclaw models list --provider qianfanCatalogo integrato
| Rif. modello | Input | Contesto | Output massimo | Reasoning | Note |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
testo | 98,304 | 32,768 | Sì | Modello predefinito |
qianfan/ernie-5.0-thinking-preview |
testo, immagine | 119,000 | 64,000 | Sì | Multimodale |
Esempio di configurazione
{ 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 viene eseguito tramite il percorso di trasporto compatibile con OpenAI, non tramite la modellazione nativa delle richieste OpenAI. Questo significa che le funzionalità standard degli SDK OpenAI funzionano, ma i parametri specifici del provider potrebbero non essere inoltrati.
Catalog and overrides
Il catalogo statico attualmente include deepseek-v3.2 e ernie-5.0-thinking-preview. Aggiungi o sovrascrivi models.providers.qianfan solo quando ti serve un URL di base personalizzato o metadati del modello personalizzati.
Troubleshooting
- Assicurati che la tua chiave API inizi con
bce-v3/ALTAK-e che l'accesso all'API Qianfan sia abilitato nella console Baidu Cloud. - Se i modelli non sono elencati, verifica che il servizio Qianfan sia attivato sul tuo account.
- L'URL di base predefinito è
https://qianfan.baidubce.com/v2. Modificalo solo se usi un endpoint o un proxy personalizzato.
Correlati
Scelta dei provider, dei riferimenti dei modelli e del comportamento di failover.
Riferimento completo alla configurazione di OpenClaw.
Configurazione dei valori predefiniti degli agenti e delle assegnazioni dei modelli.
Documentazione ufficiale dell'API Qianfan.
