Saltar al contenido
APMIX.AI

Codex CLI con apmix

Codex CLI funciona con tu clave de apmix en aproximadamente 3 min. Pega la clave una vez y cada fragmento de código de abajo queda listo para copiar, con cualquier modelo del catálogo.

URL base

  • https://api.apmix.ai/v1Compatible con OpenAI

    Chat Completions y Responses. Codex, Cursor, OpenCode, Kilo Code, Pi, Kimi, Grok, Hermes y los SDK.

  • https://api.apmix.aiCompatible con Anthropic

    Messages API. Claude Code y los SDK de Anthropic.

Tu configuración

Obtener una clave →
base_url
https://api.apmix.ai/v1
api_key
apx_live_YOUR_KEY
model
gpt-5.6-luna
  1. Instala Codex

    Requiere Node.js 18 o posterior.

    Terminal
    npm install -g @openai/codex
  2. Añade apmix como proveedor

    Codex lee los proveedores de ~/.codex/config.toml. Esto registra apmix y lo deja como predeterminado. Codex usa la Responses API, que apmix sirve en /v1/responses. El script hace antes una copia de seguridad del archivo existente.

    mkdir -p ~/.codex
    [ -f ~/.codex/config.toml ] && cp ~/.codex/config.toml ~/.codex/config.toml.bak
    cat > ~/.codex/config.toml <<'EOF'
    model = "gpt-5.6-luna"
    model_provider = "apmix"
    
    [model_providers.apmix]
    name = "apmix"
    base_url = "https://api.apmix.ai/v1"
    env_key = "APMIX_API_KEY"
    wire_api = "responses"
    EOF
  3. Configura tu clave

    Codex lee la clave de la variable APMIX_API_KEY que indica env_key. Esto la guarda tanto para la terminal actual como para las futuras.

    echo 'export APMIX_API_KEY="apx_live_YOUR_KEY"' >> ~/.zshrc   # or ~/.bashrc
    export APMIX_API_KEY="apx_live_YOUR_KEY"

    Pega tu clave arriba para completar esto

  4. Ejecútalo

    Abre una terminal nueva para que se cargue la variable y luego inicia Codex en tu proyecto. codex --model <id> cambia de modelo durante una sesión.

    Terminal
    cd your-project
    codex

Verificación

Comprueba que la clave funciona.

Consulta los modelos a los que tiene acceso tu clave. Si recibes una lista en JSON, la clave y la URL son correctas; un 401 significa que la clave es incorrecta o ha expirado.

curl https://api.apmix.ai/v1/models -H "Authorization: Bearer apx_live_YOUR_KEY"

Pega tu clave arriba para completar esto

¿Tu herramienta no aparece?

Cualquier herramienta que te permita configurar una URL base de OpenAI o de Anthropic funciona con apmix. Busca un campo Base URL o Custom provider, pega la URL y tu clave, y usa un ID de modelo del catálogo.

Ver el ejemplo con la API directa

¿Sigue sin funcionar? Escribe a support@apmix.ai con el nombre de la herramienta y el ID de tu solicitud.

Errores

Cada error, su número y qué hacer.

La API responde con un estado HTTP estándar y un cuerpo JSON que identifica el error. El code nunca cambia, así que puedes basarte en él; el message está escrito para personas. Cada respuesta incluye además un encabezado x-apmix-request-id: indícalo cuando escribas a support@apmix.ai.

Dos formatos, según el endpoint

Endpoints compatibles con OpenAI (/v1/chat/completions, /v1/responses, /v1/models, /v1/usage)
HTTP/1.1 429 Too Many Requests
x-apmix-request-id: req_5b1f…

{
  "error": {
    "message": "Your monthly allowance is used up. …",
    "type": "insufficient_quota",
    "code": "allowance_exhausted",
    "param": null
  }
}
Endpoints compatibles con Anthropic (/v1/messages, /v1/messages/count_tokens)
HTTP/1.1 429 Too Many Requests
x-apmix-request-id: req_5b1f…

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Your monthly allowance is used up. …",
    "code": "allowance_exhausted"
  }
}
400Solicitud incorrecta
  • invalid_json

    invalid_request_error

    Cuándo ocurre: El cuerpo de la solicitud no se pudo interpretar como JSON.

    Qué hacer: Revisa las comillas, las comas y el encabezado Content-Type: application/json.

  • missing_model

    invalid_request_error

    Cuándo ocurre: La solicitud no tiene el campo model.

    Qué hacer: Añade un ID de modelo del catálogo, p. ej., claude-sonnet-4-6.

  • bad_request

    invalid_request_error

    Cuándo ocurre: El modelo rechazó un parámetro (tipo incorrecto, opción no admitida, contenido demasiado largo).

    Qué hacer: Lee el message: repite el motivo que dio el modelo. Corrige el parámetro y vuelve a enviar la solicitud.

401Autenticación
  • missing_api_key

    authentication_error

    Cuándo ocurre: No se envió ninguna clave. Todos los endpoints la necesitan, incluido GET /v1/models, porque el catálogo depende de tu plan.

    Qué hacer: Envía Authorization: Bearer apx_live_… (o x-api-key en los endpoints de Anthropic).

  • invalid_api_key

    authentication_error

    Cuándo ocurre: La clave no existe o se eliminó.

    Qué hacer: Vuelve a copiarla desde Panel → Claves de API o crea una nueva.

  • key_expired

    authentication_error

    Cuándo ocurre: La clave superó la fecha de expiración que fijaste al crearla.

    Qué hacer: Crea una clave nueva; la fecha de expiración no se puede extender.

403Permisos
  • model_not_in_plan

    permission_error

    Cuándo ocurre: El modelo existe, pero está por encima de tu plan, o la cuenta aún no tiene plan. El message indica el modelo, el plan que necesita y el plan de tu clave.

    Qué hacer: Llama a GET /v1/models con la misma clave (solo muestra lo que tu plan puede usar) o mejora tu plan en Panel → Facturación.

  • account_suspended

    permission_error

    Cuándo ocurre: La cuenta se suspendió por incumplir los términos.

    Qué hacer: Escribe a support@apmix.ai desde la dirección de correo de la cuenta.

  • account_on_hold

    permission_error

    Cuándo ocurre: Se está revisando un pago de la cuenta; las solicitudes quedan en pausa hasta que se resuelva.

    Qué hacer: No tienes que hacer nada. Revisa tu correo o escribe a support@apmix.ai si tarda más de un día.

404No encontrado
  • model_not_found

    not_found_error

    Cuándo ocurre: El ID del modelo no existe o el modelo se retiró.

    Qué hacer: Usa un ID de /v1/models o de la página Modelos. Se aceptan prefijos de proveedor como anthropic/.

  • not_found

    not_found_error

    Cuándo ocurre: La ruta o el método no existen.

    Qué hacer: Usa POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, GET /v1/models o GET /v1/usage.

429Límites
  • allowance_exhausted

    insufficient_quota · rate_limit_error

    Cuándo ocurre: Se agotaron tus tokens ponderados del mes. El type es insufficient_quota, como en OpenAI.

    Qué hacer: Mejora tu plan en Panel → Facturación o espera a la fecha de renovación que aparece en la página Resumen.

  • daily_limit_reached

    rate_limit_error

    Cuándo ocurre: Alcanzaste el tope diario que fijaste tú en Configuración → Límites.

    Qué hacer: Sube o quita el tope, o espera a la medianoche UTC.

  • weekly_limit_reached

    rate_limit_error

    Cuándo ocurre: Alcanzaste el tope semanal que fijaste tú en Configuración → Límites.

    Qué hacer: Sube o quita el tope, o espera al lunes a las 00:00 UTC.

  • key_limit_reached

    insufficient_quota · rate_limit_error

    Cuándo ocurre: La clave alcanzó el límite de uso que su propietario le puso en Panel → Claves de API. El type es insufficient_quota.

    Qué hacer: Pide al propietario de la clave que suba o quite su límite de uso; la clave vuelve a funcionar al instante.

  • rate_limit_exceeded

    rate_limit_error

    Se puede reintentar

    Cuándo ocurre: Más de 60 solicitudes en un minuto con una misma clave (120 en Max).

    Qué hacer: Espera los segundos que indique retry-after. Reparte los trabajos pesados entre varias claves.

  • upstream_rate_limited

    rate_limit_error

    Se puede reintentar

    Cuándo ocurre: El propio modelo está saturado en este momento.

    Qué hacer: Reintenta con esperas crecientes (1 s, 2 s, 4 s). No se cobró nada.

502Proveedor
  • upstream_error

    api_error

    Se puede reintentar

    Cuándo ocurre: El modelo devolvió una respuesta dañada o inesperada.

    Qué hacer: Reintenta una vez; si se repite, prueba con otro modelo. No se cobró nada.

503No disponible
  • upstream_unavailable

    api_error · overloaded_error

    Se puede reintentar

    Cuándo ocurre: El modelo agotó el tiempo de espera o está fuera de servicio por mantenimiento.

    Qué hacer: Reintenta en un momento o cambia de modelo. No se cobró nada.

  • no_provider

    api_error · overloaded_error

    Se puede reintentar

    Cuándo ocurre: El modelo no tiene ninguna ruta activa por nuestra parte (poco habitual, durante tareas de mantenimiento).

    Qué hacer: Reintenta en unos minutos o elige otro modelo.

Los errores marcados como “se puede reintentar” son transitorios: espera uno o dos segundos y vuelve a enviar la misma solicitud (la mayoría de los SDK lo hacen automáticamente con 429 y 5xx). Todo lo demás requiere antes un cambio por tu parte.

Encabezados de respuesta útiles

x-apmix-request-id
ID único de esta solicitud. Inclúyelo cuando escribas a support@apmix.ai.
x-apmix-remaining
Tokens ponderados que quedan en tu cuota mensual después de esta solicitud.
x-apmix-key-remaining
Tokens ponderados que le quedan a esta clave, cuando tiene un límite de uso.
x-apmix-weighted-tokens
Lo que costó esta solicitud, ya aplicado el multiplicador del modelo.
retry-after
Segundos que debes esperar; se envía con rate_limit_exceeded.