---
read_when:
    - Quieres una única clave de API para muchos LLM.
    - Necesita orientación para configurar Baidu Qianfan
summary: Usa la API unificada de Qianfan para acceder a numerosos modelos en OpenClaw
title: Qianfan
x-i18n:
    generated_at: "2026-07-26T05:19:14Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 31387a53ee4472e2d20ae939ea75cea0d6f6367501becd56a8654fd97fdf0804
    source_path: providers/qianfan.md
    workflow: 16
---

Qianfan es la plataforma MaaS de Baidu: una API unificada y compatible con OpenAI que dirige las solicitudes a numerosos modelos mediante un único endpoint y una única clave de API. OpenClaw la distribuye como el Plugin externo oficial `@openclaw/qianfan-provider`.

| Propiedad     | Valor                                    |
| ------------- | ---------------------------------------- |
| Proveedor     | `qianfan`                                |
| Autenticación | `QIANFAN_API_KEY`                        |
| API           | Compatible con OpenAI (`openai-completions`) |
| URL base      | `https://qianfan.baidubce.com/v2`        |
| Modelo predeterminado | `qianfan/deepseek-v3.2`                  |

## Instalar el Plugin

Instale el Plugin oficial y, a continuación, reinicie el Gateway:

```bash
openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart
```

## Primeros pasos

<Steps>
  <Step title="Crear una cuenta de Baidu Cloud">
    Regístrese o inicie sesión en la [consola de Qianfan](https://console.bce.baidu.com/qianfan/ais/console/apiKey) y asegúrese de tener habilitado el acceso a la API de Qianfan.
  </Step>
  <Step title="Generar una clave de API">
    Cree una aplicación nueva o seleccione una existente y, a continuación, genere una clave de API. Las claves de Baidu Cloud usan el formato `bce-v3/ALTAK-...`.
  </Step>
  <Step title="Ejecutar la incorporación">
    ```bash
    openclaw onboard --auth-choice qianfan-api-key
    ```

    Las ejecuciones no interactivas leen la clave de `--qianfan-api-key <key>` o
    `QIANFAN_API_KEY`. La incorporación escribe la configuración del proveedor, añade el
    alias `QIANFAN` para el modelo predeterminado y establece `qianfan/deepseek-v3.2`
    como modelo predeterminado cuando no hay ninguno configurado.

  </Step>
  <Step title="Verificar que el modelo esté disponible">
    ```bash
    openclaw models list --provider qianfan
    ```
  </Step>
</Steps>

## Catálogo integrado

| Referencia del 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             |

El catálogo es estático; no se detectan modelos en tiempo real.

<Tip>
Solo es necesario reemplazar `models.providers.qianfan` cuando se requiere una URL base personalizada o metadatos de modelos personalizados.
</Tip>

## Ejemplo de configuración

```json5
{
  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,
          },
        ],
      },
    },
  },
}
```

<Note>
Las referencias de modelos usan el prefijo `qianfan/` (por ejemplo, `qianfan/deepseek-v3.2`).
</Note>

<AccordionGroup>
  <Accordion title="Transporte y compatibilidad">
    Qianfan funciona mediante la ruta de transporte compatible con OpenAI, no mediante el formato nativo de solicitudes de OpenAI. Las funciones estándar del SDK de OpenAI funcionan, pero es posible que los parámetros específicos del proveedor no se reenvíen.
  </Accordion>

  <Accordion title="Solución de problemas">
    - Asegúrese de que la clave de API comience por `bce-v3/ALTAK-` y de que tenga habilitado el acceso a la API de Qianfan en la consola de Baidu Cloud.
    - Si los modelos no aparecen, confirme que el servicio Qianfan esté activado en la cuenta.
    - Cambie la URL base únicamente si utiliza un endpoint o proxy personalizado.

  </Accordion>
</AccordionGroup>

## Contenido relacionado

<CardGroup cols={2}>
  <Card title="Selección de modelos" href="/es/concepts/model-providers" icon="layers">
    Selección de proveedores, referencias de modelos y comportamiento de conmutación por error.
  </Card>
  <Card title="Referencia de configuración" href="/es/gateway/configuration-reference" icon="gear">
    Referencia completa de configuración de OpenClaw.
  </Card>
  <Card title="Configuración del agente" href="/es/concepts/agent" icon="robot">
    Configuración de los valores predeterminados del agente y las asignaciones de modelos.
  </Card>
  <Card title="Documentación de la API de Qianfan" href="https://cloud.baidu.com/doc/qianfan-api/s/3m7of64lb" icon="arrow-up-right-from-square">
    Documentación oficial de la API de Qianfan.
  </Card>
</CardGroup>
