Saltar al contenido
APMIX.AI

Cualquier SDK o curl con apmix

Cualquier SDK o curl funciona con tu clave de apmix en aproximadamente 1 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. Haz una solicitud

    Las mismas rutas y el mismo JSON que OpenAI. Solo cambian el host y la clave.

    curl https://api.apmix.ai/v1/chat/completions \
      -H "Authorization: Bearer apx_live_YOUR_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"Say hello in five words."}]}'

    Pega tu clave arriba para completar esto

  2. OpenAI SDK

    Cambia base_url y api_key; todo lo demás queda igual.

    from openai import OpenAI
    
    client = OpenAI(base_url="https://api.apmix.ai/v1", api_key="apx_live_YOUR_KEY")
    
    reply = client.chat.completions.create(
        model="gpt-5.6-luna",
        messages=[{"role": "user", "content": "Say hello in five words."}],
    )
    print(reply.choices[0].message.content)

    Pega tu clave arriba para completar esto

  3. Anthropic SDK

    Para usar modelos Claude con el protocolo de Anthropic, apunta base_url a la URL compatible con Anthropic.

    from anthropic import Anthropic
    
    client = Anthropic(base_url="https://api.apmix.ai", api_key="apx_live_YOUR_KEY")
    
    reply = client.messages.create(
        model="gpt-5.6-luna",
        max_tokens=256,
        messages=[{"role": "user", "content": "Say hello in five words."}],
    )
    print(reply.content[0].text)

    Pega tu clave arriba para completar esto

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.