OpenCode Zen

Zen es el servicio opcional de modelos con pago por uso de OpenCode. Puedes seguir utilizando otros proveedores. Un cliente gratuito no implica inferencia gratuita.

Conectar y elegir modelo

1. Entra en la consola oficial (opens in a new tab), revisa la facturación y copia una clave de API.
2. En la TUI, ejecuta /connect, selecciona OpenCode Zen e introduce la clave. No guardes credenciales en Git.
3. Elige un modelo con /models, envía una petición pequeña sin datos sensibles y consulta el consumo.

Los identificadores son opencode/<model-id>. Usa el catálogo actual (opens in a new tab), no un nombre supuesto. Para fijar la selección, escribe el identificador verificado en model de la configuración.

Tras conectar Zen, esta configuración del proyecto selecciona GPT 5.5. Puedes cambiarlo por otro ID disponible de la tabla.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/gpt-5.5"
}

Protocolos y API directas

El prefijo es https://opencode.ai/zen/v1/. Según el modelo, se usa responses con el adaptador OpenAI, messages con Anthropic, chat/completions con el compatible, o endpoints propios de Google. Consulta la tabla de endpoints de esta página. La conexión integrada Zen gestiona esta correspondencia; no todos los modelos usan Chat Completions.

Jev devuelve decisiones estructuradas mediante https://opencode.ai/zen/v1/systemone, en lugar de texto generado. Sus tipos de preguntas incluyen noul, choice y score. Revisa el ejemplo Jev de esta página para el ID y formato actuales.

Lista de modelos y endpoints

Las tablas muestran IDs, endpoints y precios de Zen. Confirma la disponibilidad en el catálogo actual: algunos modelos que siguen en las tablas de referencia ya se han retirado. El prefijo opencode/ se usa en la configuración del cliente; las solicitudes API directas usan el ID sin ese prefijo.

Jev

Configura OPENCODE_API_KEY con tu clave de Zen en el entorno de la terminal. El ejemplo pregunta si una solicitud es urgente: noul es una pregunta de sí/no, choice permite opciones con nombre y score una evaluación con criterios. El ejemplo utiliza un modelo de pago.

curl https://opencode.ai/zen/v1/systemone \
  -H "Authorization: Bearer $OPENCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "My payments have failed for three days and I am losing sales. Please help now.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this request require urgent attention?"
      }
    }
  }'

Precios y control del gasto

Comprueba entrada, salida, caché, contexto largo y comisiones de pago en la tabla de precios de esta página y la consola. Las ofertas gratuitas pueden terminar y tener otras condiciones de datos. Revisa los modelos retirados en el catálogo actual. La generación de títulos de sesión puede aparecer como consumo de modelos pequeños.

La recarga automática cobra al método de pago cuando el saldo baja del umbral. Puedes cambiar la cantidad o desactivarla. Revisa la configuración antes de ejecutar un agente sin supervisión.

El límite mensual de uso controla consumo por espacio o miembro, no el total de transacciones de pago. Las recargas pueden cobrar más que ese límite. Revisa saldo, recarga y límites conjuntamente.

Precios por token

Los precios están en dólares estadounidenses por millón de tokens. Entrada, salida y lectura y escritura de caché se facturan por separado; aplica el tramo de contexto indicado. Un guion no significa gratis. Las imágenes también pueden generar tokens facturables, por ejemplo con DeepSeek V4 Flash Vision Exp.

Modelos gratuitos

Los siguientes modelos tienen una oferta gratuita. La disponibilidad y las condiciones de datos varían; no implica uso ilimitado ni gratuito para siempre. Jev devuelve decisiones estructuradas y no sustituye a un modelo que genera texto para programar.

• Big Pickle
• MiMo-V2.5 Free
• Ling 3.0 Flash Fin Free
• Nemotron 3 Ultra Free
• Nemotron 3.5 Lightning Free
• Muse Spark 1.3 Contributor Free
• Jev 1.13 Free

Ejemplo de coste

Con MiniMax M3, 100.000 tokens de entrada sin caché y 20.000 de salida cuestan 0,1 × $0.30 + 0,02 × $1.20 = $0.054, antes de otros cargos. Los reintentos y el contexto repetido suman consumo. La comisión de pago indicada es del 4,4 % + $0.30 por transacción; confirma el cargo en la consola.

Recarga automática

Si tu saldo baja de $5, Zen recargará automáticamente $20.

Puedes cambiar el monto de la recarga automática. También puedes desactivar por completo la recarga automática.

Límites mensuales

También puedes establecer un límite de uso mensual para todo el workspace y para cada miembro de tu equipo.

Por ejemplo, supongamos que estableces un límite de uso mensual de $20. Zen no usará más de $20 en un mes. Pero si tienes habilitada la recarga automática, Zen podría terminar cobrándote más de $20 si tu saldo baja de $5.

Modelos retirados

Privacidad

Lee la sección actual por modelo (opens in a new tab). La fuente describe alojamiento en EE. UU. y políticas de retención con excepciones; no garantiza retención cero para todos.

Entre las excepciones están retención en API de OpenAI y Anthropic, posibles usos de mejora en algunos modelos gratuitos, registros de prueba de NVIDIA y entrenamiento en Muse Spark Contributor. La advertencia de prueba de NVIDIA indica no enviar datos personales o confidenciales. Comprueba las condiciones concretas y acuerdos con vencimiento.

Equipos y claves propias

Admin gestiona modelos, miembros, claves y facturación; Member, solo sus claves. Los administradores pueden limitar gastos y desactivar modelos. Una petición a un modelo desactivado falla, sin demostrar que la clave esté rota. Un espacio gratuito temporal no supone gratuidad permanente.

Al usar tu propia clave de OpenAI o Anthropic, ese proveedor factura los tokens directamente, no Zen. Comprueba qué cuenta paga antes de comparar consumo.

Roles

Puedes invitar a compañeros de equipo a tu workspace y asignar roles:

• Admin : Gestiona modelos, miembros, API keys y facturación
• Member : Gestiona solo sus propias API keys

Los admins también pueden establecer límites mensuales de gasto para cada miembro para mantener los costos bajo control.

Acceso a modelos

Los admins pueden habilitar o deshabilitar modelos específicos para el workspace. Las solicitudes realizadas a un modelo deshabilitado devolverán un error.

Esto resulta útil en los casos en los que quieres deshabilitar el uso de un modelo que recopila datos.

Usar tu propia clave

Puedes usar tus propias API keys de OpenAI o Anthropic mientras sigues accediendo a otros modelos en Zen.

Cuando usas tus propias keys, los tokens te los factura directamente el proveedor, no Zen.

Por ejemplo, tu organización podría ya tener una key para OpenAI o Anthropic y quieres usarla en lugar de la que proporciona Zen.

Diagnóstico

Para 401/403, revisa clave, espacio y acceso; si falta un modelo, ID y retirada; ante límites, saldo y controles de gasto. Consulta red y resolución de problemas.

Guías relacionadas

• Configurar proveedores
• Elegir modelos
• Red
• Solución de problemas

Fuente de la documentación (MIT)