Saltar al contenido
APMIX.AI

Kilo Code con apmix

Kilo Code funciona con tu clave de apmix en aproximadamente 2 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 Kilo Code

    En VS Code o en un IDE de JetBrains, instala la extensión Kilo Code desde el marketplace. Para la terminal, instala la CLI; requiere Node.js 18 o posterior.

    Terminal
    npm install -g @kilocode/cli
  2. Añade apmix como proveedor personalizado

    En la extensión, abre Settings (el engranaje), ve a Providers y haz clic en Custom provider. Elige OpenAI Compatible y completa los campos de abajo; Kilo mostrará todos los modelos de apmix directamente desde /v1/models: elige uno y guarda.

    Valores
    Provider ID     apmix
    Provider API    OpenAI Compatible
    Base URL        https://api.apmix.ai/v1
    API key         apx_live_YOUR_KEY
    Model           gpt-5.6-luna

    Pega tu clave arriba para completar esto

  3. Lo mismo para la CLI

    La CLI lee ~/.config/kilo/kilo.jsonc: es un fork de OpenCode y usa el mismo formato. Esto registra apmix y lo deja como predeterminado; reinicia la CLI después de editar el archivo. Añade más IDs del catálogo a models cuando quieras.

    mkdir -p ~/.config/kilo
    [ -f ~/.config/kilo/kilo.jsonc ] && cp ~/.config/kilo/kilo.jsonc ~/.config/kilo/kilo.jsonc.bak
    cat > ~/.config/kilo/kilo.jsonc <<'EOF'
    {
      "$schema": "https://app.kilo.ai/config.json",
      "model": "apmix/gpt-5.6-luna",
      "provider": {
        "apmix": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "apmix",
          "options": {
            "baseURL": "https://api.apmix.ai/v1",
            "apiKey": "apx_live_YOUR_KEY"
          },
          "models": {
            "gpt-5.6-luna": {
              "name": "GPT 5.6 Luna",
              "tool_call": true
            },
            "claude-sonnet-5": {
              "name": "Claude Sonnet 5",
              "tool_call": true
            },
            "gemini-3.1-pro": {
              "name": "Gemini 3.1 Pro",
              "tool_call": true
            }
          }
        }
      }
    }
    EOF

    Pega tu clave arriba para completar esto

  4. Ejecútalo

    Inicia Kilo dentro de tu proyecto y elige un modelo con /models. En el editor, elígelo en el selector de modelos que hay bajo el cuadro de chat.

    Terminal
    cd your-project
    kilo

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.