Qianfan

Qianfan est la plateforme MaaS de Baidu, fournissant une API unifiée qui achemine les demandes vers de nombreux modèles derrière un seul point de terminaison et une seule clé API. Elle est compatible OpenAI, donc la plupart des SDK OpenAI fonctionnent en changeant l’URL de base.

Propriété	Valeur
Fournisseur	`qianfan`
Auth	`QIANFAN_API_KEY`
API	OpenAI-compatible
URL de base	`https://qianfan.baidubce.com/v2`

Getting started

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'intégration
bash openclaw onboard --auth-choice qianfan-api-key
Vérifier que le modèle est disponible
bash openclaw models list --provider qianfan

Catalogue intégré

Réf. modèle	Entrée	Contexte	Max sortie	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 OpenAI, et non via le formatage des requêtes OpenAI natif. Cela signifie que les fonctionnalités standard des SDK OpenAI fonctionnent, mais que les paramètres spécifiques au fournisseur peuvent ne pas être transmis.

Catalogue et remplacements

Le catalogue groupé 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 votre compte a le service Qianfan activé.
L’URL de base par défaut est https://qianfan.baidubce.com/v2. Ne la modifiez que si vous utilisez un endpoint personnalisé ou un proxy.

Connexes

Sélection de 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 de l'agent

Configuration des valeurs par défaut de l’agent et des affectations de modèle.

Documentation de l'API Qianfan

Documentation officielle de l’API Qianfan.