Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Qianfan es la plataforma MaaS de Baidu, que proporciona una API unificada que enruta solicitudes a muchos modelos detrás de un único punto de conexión y clave de API. Es compatible con OpenAI, por lo que la mayoría de los SDK de OpenAI funcionan cambiando la URL base.
PropiedadValor
Proveedorqianfan
AutenticaciónQIANFAN_API_KEY
APICompatible con OpenAI
URL basehttps://qianfan.baidubce.com/v2

​
Primeros pasos

1

Create a Baidu Cloud account

Regístrate o inicia sesión en la consola de Qianfan y asegúrate de tener habilitado el acceso a la API de Qianfan.
2

Generate an API key

Crea una aplicación nueva o selecciona una existente y luego genera una clave de API. El formato de la clave es bce-v3/ALTAK-....
3

Run onboarding

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

Verify the model is available

openclaw models list --provider qianfan

​
Catálogo integrado

Referencia del modeloEntradaContextoSalida máximaRazonamientoNotas
qianfan/deepseek-v3.2texto98,30432,768SíModelo predeterminado
qianfan/ernie-5.0-thinking-previewtexto, imagen119,00064,000SíMultimodal
La referencia de modelo incluida predeterminada es qianfan/deepseek-v3.2. Solo necesitas sobrescribir models.providers.qianfan cuando necesites una URL base personalizada o metadatos de modelo.

​
Ejemplo de configuración

{
  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 se ejecuta mediante la ruta de transporte compatible con OpenAI, no mediante la conformación nativa de solicitudes de OpenAI. Esto significa que las funciones estándar de los SDK de OpenAI funcionan, pero es posible que no se reenvíen los parámetros específicos del proveedor.
El catálogo incluido actualmente incluye deepseek-v3.2 y ernie-5.0-thinking-preview. Añade o sobrescribe models.providers.qianfan solo cuando necesites una URL base personalizada o metadatos de modelo.
Las referencias de modelo usan el prefijo qianfan/ (por ejemplo, qianfan/deepseek-v3.2).
  • Asegúrate de que tu clave de API empiece por bce-v3/ALTAK- y tenga habilitado el acceso a la API de Qianfan en la consola de Baidu Cloud.
  • Si los modelos no aparecen en la lista, confirma que tu cuenta tenga activado el servicio Qianfan.
  • La URL base predeterminada es https://qianfan.baidubce.com/v2. Cámbiala solo si usas un punto de conexión personalizado o un proxy.

​
Relacionado

Model selection

Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.

Configuration reference

Referencia completa de configuración de OpenClaw.

Agent setup

Configurar valores predeterminados de agentes y asignaciones de modelos.

Qianfan API docs

Documentación oficial de la API de Qianfan.