Qianfan

Qianfan es la plataforma MaaS de Baidu, que proporciona una API unificada que enruta las solicitudes a muchos modelos detrás de un único punto de conexión (endpoint) y clave de API. Es compatible con OpenAI, por lo que la mayoría de los SDK de OpenAI funcionan simplemente cambiando la URL base.

Propiedad	Valor
Proveedor	`qianfan`
Autenticación	`QIANFAN_API_KEY`
API	Compatible con OpenAI
URL base	`https://qianfan.baidubce.com/v2`

Primeros pasos

Crear una cuenta de Baidu Cloud
Regístrese o inicie sesión en la Consola de Qianfan y asegúrese de tener habilitado el acceso a la API de Qianfan.
Generar una clave de API
Cree una nueva aplicación o seleccione una existente, luego genere una clave de API. El formato de la clave es bce-v3/ALTAK-....
Ejecutar la incorporación (onboarding)
bash openclaw onboard --auth-choice qianfan-api-key
Verificar que el modelo esté disponible
bash openclaw models list --provider qianfan

Catálogo integrado

Ref. de modelo	Entrada	Contexto	Salida máxima	Razonamiento	Notas
`qianfan/deepseek-v3.2`	texto	98,304	32,768	Sí	Modelo predeterminado
`qianfan/ernie-5.0-thinking-preview`	texto, imagen	119,000	64,000	Sí	Multimodal

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,
          },
        ],
      },
    },
  },
}

Transporte y compatibilidad

Qianfan se ejecuta a través de la ruta de transporte compatible con OpenAI, no mediante el modelado de solicitudes nativo de OpenAI. Esto significa que las funciones estándar del SDK de OpenAI funcionan, pero es posible que los parámetros específicos del proveedor no se reenvíen.

Catálogo y anulaciones

El catálogo incluido actualmente contiene deepseek-v3.2 y ernie-5.0-thinking-preview. Agregue o anule models.providers.qianfan solo cuando necesite una URL base personalizada o metadatos del modelo.

Solución de problemas

Asegúrese de que su clave de API comience con bce-v3/ALTAK- y tenga el acceso a la API de Qianfan habilitado en la consola de Baidu Cloud.
Si no se listan los modelos, confirme que su cuenta tiene el servicio Qianfan activado.
La URL base predeterminada es https://qianfan.baidubce.com/v2. Cámbiela solo si utiliza un endpoint personalizado o un proxy.

Relacionado

Selección de modelo

Elección de proveedores, referencias de modelos y comportamiento de conmutación por error.

Referencia de configuración

Referencia completa de configuración de OpenClaw.

Configuración del agente

Configuración de valores predeterminados del agente y asignaciones de modelos.

Documentación de la API de Qianfan

Documentación oficial de la API de Qianfan.