Passer au contenu principal
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 clé API unique. Elle est compatible OpenAI, donc la plupart des SDK OpenAI fonctionnent en changeant l’URL de base.
PropriétéValeur
Fournisseurqianfan
AuthentificationQIANFAN_API_KEY
APICompatible OpenAI
URL de basehttps://qianfan.baidubce.com/v2

​
Installer le Plugin

Installez le Plugin officiel, puis redémarrez Gateway : 
openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

​
Premiers pas

1

Create a Baidu Cloud account

Inscrivez-vous ou connectez-vous à la console Qianfan et assurez-vous que l’accès à l’API Qianfan est activé.
2

Generate an API key

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-....
3

Run onboarding

openclaw onboard --auth-choice qianfan-api-key
4

Verify the model is available

openclaw models list --provider qianfan

​
Catalogue intégré

Référence du modèleEntréeContexteSortie max.RaisonnementNotes
qianfan/deepseek-v3.2texte98,30432,768OuiModèle par défaut
qianfan/ernie-5.0-thinking-previewtexte, image119,00064,000OuiMultimodal
La référence de modèle par défaut est qianfan/deepseek-v3.2. Vous ne devez remplacer models.providers.qianfan que lorsque vous avez besoin d’une URL de base personnalisée ou de métadonnées de modèle.

​
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,
          },
        ],
      },
    },
  },
}
Qianfan utilise le chemin de transport compatible OpenAI, et non 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.
Le catalogue statique 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.
Les références de modèle utilisent le préfixe qianfan/ (par exemple qianfan/deepseek-v3.2).
  • 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, vérifiez 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.

​
Associés

Model selection

Choisir les fournisseurs, les références de modèle et le comportement de basculement.

Configuration reference

Référence complète de configuration OpenClaw.

Agent setup

Configurer les valeurs par défaut des agents et les affectations de modèles.

Qianfan API docs

Documentation officielle de l’API Qianfan.