Providers
Qianfan
Qianfan est la plateforme MaaS de Baidu, fournissant une API unifiée qui achemine les requêtes vers de nombreux modèles derrière un seul point de terminaison et une seule clé API. Elle est compatible avec OpenAI, donc la plupart des SDK OpenAI fonctionnent en changeant l’URL de base.
| Propriété | Valeur |
|---|---|
| Fournisseur | qianfan |
| Authentification | QIANFAN_API_KEY |
| API | Compatible avec OpenAI |
| URL de base | https://qianfan.baidubce.com/v2 |
Prise en main
Créer un compte Baidu Cloud
Inscrivez-vous ou connectez-vous à la console Qianfan et assurez-vous que l’accès à l’API Qianfan est activé.
Générer une clé API
Créez une nouvelle application ou sélectionnez-en une existante, puis générez une clé API. Le format de la clé est bce-v3/ALTAK-....
Exécuter l’onboarding
openclaw onboard --auth-choice qianfan-api-key
Vérifier que le modèle est disponible
openclaw models list --provider qianfan
Catalogue intégré
| Référence du modèle | Entrée | Contexte | Sortie max. | Raisonnement | Notes |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
texte | 98,304 | 32,768 | Oui | Modèle par défaut |
qianfan/ernie-5.0-thinking-preview |
texte, image | 119,000 | 64,000 | Oui | Multimodal |
Exemple de configuration
{
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 et compatibilité
Qianfan fonctionne via le chemin de transport compatible avec OpenAI, et non via la mise en forme native des requêtes OpenAI. Cela signifie que les fonctionnalités standard des SDK OpenAI fonctionnent, mais que les paramètres propres au fournisseur peuvent ne pas être transmis.
Catalogue et remplacements
Le catalogue intégré inclut actuellement deepseek-v3.2 et ernie-5.0-thinking-preview. Ajoutez ou remplacez models.providers.qianfan uniquement lorsque vous avez besoin d’une URL de base personnalisée ou de métadonnées de modèle.
Dépannage
- Assurez-vous que votre clé API commence par
bce-v3/ALTAK-et que l’accès à l’API Qianfan est activé dans la console Baidu Cloud. - Si les modèles ne sont pas listés, confirmez que le service Qianfan est activé pour votre compte.
- L’URL de base par défaut est
https://qianfan.baidubce.com/v2. Ne la modifiez que si vous utilisez un point de terminaison personnalisé ou un proxy.
Connexe
Choisir les fournisseurs, les références de modèle et le comportement de basculement.
Référence complète de la configuration OpenClaw.
Configurer les valeurs par défaut des agents et les affectations de modèles.
Documentation officielle de l’API Qianfan.