Saltar al contenido principal

Usar con herramientas de programación

Cualquier herramienta de programación o cliente que acepte un endpoint personalizado compatible con OpenAI puede usar la API de ZAI. Todas las herramientas necesitan los mismos tres ajustes:

AjusteValor
Base URLhttps://api.ourzai.com/v1
API KeyUna clave creada en la página Claves de API (API keys) de la consola para desarrolladores
ModeloUn ID de modelo del catálogo de modelos, escrito exactamente igual

Las interfaces de las herramientas cambian entre versiones. Los pasos siguientes indican el nombre de cada ajuste en cada herramienta; si no encuentras alguno, rellena los tres ajustes anteriores donde la herramienta los pida. Una herramienta de programación puede enviar muchas solicitudes para completar una sola tarea, y cada una se cobra de tu saldo según el uso, así que conviene fijar un límite de gasto en la clave. Consulta Obtener una clave.

Comprueba qué endpoints ofrece un modelo

Todos los modelos de chat admiten chat.completions; solo algunos ofrecen además responses o el endpoint messages de Anthropic. Codex necesita responses y Claude Code necesita messages. Antes de elegir un modelo, revisa sus endpoints en Catálogo e integración de modelos.

Cline​

  1. Abre los ajustes de Cline y en «API Provider» elige OpenAI Compatible.
  2. En «Base URL», escribe https://api.ourzai.com/v1.
  3. Introduce tu clave en «API Key».
  4. En «Model ID», escribe el ID de un modelo de chat que admita chat.completions.

Cursor​

  1. Abre Cursor Settings → Models.
  2. En API Keys, introduce tu clave como OpenAI API Key, activa Override OpenAI Base URL y escribe https://api.ourzai.com/v1.
  3. Añade a la lista de modelos los ID que quieras usar y actívalos.

Tu propia clave solo se usa con los modelos que eliges en el chat y en Agent. Las funciones integradas de Cursor, como el autocompletado Tab, siguen funcionando con el servicio de Cursor.

Codex CLI​

Codex llama a los modelos a través del endpoint Responses, así que elige un modelo que ofrezca responses. Añade lo siguiente a ~/.codex/config.toml:

model = "<model ID that offers responses>"
model_provider = "zai"

[model_providers.zai]
name = "ZAI"
base_url = "https://api.ourzai.com/v1"
env_key = "ZAI_API_KEY"
wire_api = "responses"

Después define la clave en la terminal donde inicias Codex:

export ZAI_API_KEY="<your API key>"

En Windows PowerShell, usa $env:ZAI_API_KEY = "<your API key>".

Claude Code​

Claude Code llama a los modelos a través del endpoint Messages de Anthropic, así que solo funcionan los modelos que ofrecen messages. Define estas variables de entorno antes de iniciarlo:

export ANTHROPIC_BASE_URL="https://api.ourzai.com"
export ANTHROPIC_AUTH_TOKEN="<your API key>"
export ANTHROPIC_MODEL="<model ID that offers messages>"
export ANTHROPIC_DEFAULT_OPUS_MODEL="<the same model ID>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="<the same model ID>"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="<the same model ID>"
claude
  • No añadas /v1 a ANTHROPIC_BASE_URL: Claude Code agrega /v1/messages por su cuenta.
  • Claude Code usa por defecto otras gamas de modelos para tareas en segundo plano y subagentes. Haz que las tres variables ANTHROPIC_DEFAULT_*_MODEL apunten a un modelo que la plataforma ofrezca con messages, para que nunca pida un modelo que la plataforma no tiene y reciba un 404.
  • En Windows PowerShell, define las mismas variables con $env:NAME = "value".

Otros clientes compatibles con OpenAI​

En aplicaciones como Chatbox, Cherry Studio, LobeChat, Open WebUI, Dify y n8n, añade un proveedor del tipo «compatible con OpenAI» u «OpenAI personalizado» y rellena los tres ajustes del principio de esta página. Para las herramientas que leen las variables de entorno estándar de OpenAI, consulta Usar variables de entorno.

Si las solicitudes fallan tras la configuración, busca el código de estado en Errores, límites y uso: un 401 suele indicar una clave incorrecta, y un 404, un ID de modelo mal escrito o un modelo que no admite ese endpoint.