Autenticación

Cada solicitud lleva una clave de API de la consola. Las claves empiezan con inferray_.

Envía la clave

Envíala como token Bearer:

curl https://api.inferray.com/v1/chat/completions \
  -H "Authorization: Bearer $INFERRAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.5", "messages": [{"role": "user", "content": "Hello"}]}'

Los clientes de Anthropic envían x-api-key en su lugar. Inferray lee cualquiera de los dos headers en todos los endpoints.

Nunca pongas una clave en una URL ni en un query string, y nunca la incluyas en un navegador ni en una app móvil: cualquiera que la tenga puede gastar tu saldo. Llama a Inferray desde tu servidor y guarda la clave en una variable de entorno o en un gestor de secretos.

A qué pertenece una clave

Una clave pertenece a un proyecto, y el proyecto pertenece a una organización. Cada solicitud que hace una clave se factura a esa organización y aparece en los logs y en las analíticas de ese proyecto. Crea una clave por app o por entorno para que el uso quede separado y puedas reemplazar una clave filtrada sin tocar las demás; consulta Claves de API y proyectos.

Las claves creadas en un workspace de Token Plan consumen el crédito mensual del plan en lugar de un saldo.

Cuando falla la autenticación

Estado	Significado
`401`	Falta la clave, tiene un formato incorrecto, se eliminó o se rotó. Revisa el header y la clave.
`429`	Demasiadas solicitudes o demasiados intentos fallidos. Espera `Retry-After`.
`503`	No se pudo verificar la clave en este momento. Puede ser perfectamente válida; vuelve a intentarlo en breve. No se envió ni se cobró nada.

Verifica una clave desde la API

GET /v1/key describe la clave que hace la solicitud: su nombre, lo que ha gastado hasta ahora y, en el caso de una clave de Token Plan, el crédito del plan.

curl https://api.inferray.com/v1/key \
  -H "Authorization: Bearer $INFERRAY_API_KEY"

{
  "data": {
    "label": "Production",
    "usage": "12.48",
    "limit": null,
    "devPlan": "none",
    "devPlanCreditsUsed": "0",
    "devPlanCreditsLimit": "0",
    "devPlanCreditsRemaining": "0"
  }
}

Los montos están en USD, como strings. usage es lo que ha gastado esta clave.

Para una clave de Token Plan, devPlan indica el nivel del plan y los tres campos devPlanCredits muestran el crédito usado, el crédito del período y lo que queda.

GET /v1/credits devuelve el saldo prepagado de la organización y su gasto total:

{ "balance": "87.52", "total_used": "112.48" }

Ambos endpoints son gratuitos y solo describen tu propia organización. Son útiles como health check en un script de deploy o para avisar antes de que se agote un saldo.

Solicitudes desde el navegador

La API responde a solicitudes cross-origin, así que las herramientas que se ejecutan en un navegador (notebooks, playgrounds locales) pueden llamarla. Eso no convierte al navegador en un lugar seguro para una clave: úsala solo con una clave tuya en una máquina que controles.