Passer au contenu principal

​
Qianfan

Qianfan est la plateforme MaaS de Baidu, fournissant une API unifiée qui route les requêtes vers de nombreux modèles derrière un unique point de terminaison et une unique clé API. Elle est compatible OpenAI, donc la plupart des SDK OpenAI fonctionnent en changeant simplement l’URL de base.
PropertyValue
Providerqianfan
AuthQIANFAN_API_KEY
APICompatible OpenAI
Base URLhttps://qianfan.baidubce.com/v2

​
Premiers pas

1

Créer un compte Baidu Cloud

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

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

Exécuter l’onboarding

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

Vérifier que le modèle est disponible

openclaw models list --provider qianfan

​
Modèles disponibles

Model refInputContextMax outputReasoningNotes
qianfan/deepseek-v3.2text98,30432,768OuiModèle par défaut
qianfan/ernie-5.0-thinking-previewtext, image119,00064,000OuiMultimodal
La référence de modèle intégrée par défaut est qianfan/deepseek-v3.2. Vous n’avez besoin de remplacer models.providers.qianfan que si vous avez besoin d’une URL de base personnalisée ou de métadonnées de modèle personnalisées.

​
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 fonctionne via le chemin de transport compatible OpenAI, et non via la mise en forme native des requêtes OpenAI. Cela signifie que les fonctionnalités standard du SDK OpenAI fonctionnent, mais que les paramètres spécifiques au fournisseur peuvent ne pas être transmis.
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 personnalisées.
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, confirmez que le service Qianfan est activé sur 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élection du modèle

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

Référence de configuration

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

Configuration d’agent

Configuration des valeurs par défaut des agents et des affectations de modèle.

Documentation API Qianfan

Documentation officielle de l’API Qianfan.