Referencia de la API

URL base

Cada solicitud va a:

Autenticación

Crea una clave en la página claves de API y envíala como token bearer en el encabezado Authorization. Solo se almacena un hash de tu clave — cópiala al crearla, porque GatifyAI no podrá mostrártela de nuevo.

Inicio rápido

Una solicitud mínima en curl, Python o TypeScript:

curl https://gatifyai.com/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Restringir una clave a modelos específicos

Por defecto, una clave nueva puede usar cualquier modelo gratuito de GatifyAI, con el mismo fallback automático que usa el chat web si uno no está disponible. En su lugar, puedes restringir una clave a un modelo específico o a una lista corta — la clave entonces solo usará modelos de esa lista, en el orden que indicaste, sin importar qué modelo pida una solicitud. Solicitar un modelo fuera de esa lista devuelve un error 400 con los modelos que la clave realmente puede usar.

Chatear como una persona

Envía model: "persona/<slug>" para chatear como una persona publicada en la galería de la comunidad — su personalidad y modelos preferidos se usan automáticamente, aún restringidos por los modelos permitidos de tu clave si configuraste alguno. Encuentra el slug de una persona y un ejemplo listo en su propia página, en la pestaña API.

{
  "model": "persona/senior-engineer",
  "messages": [{"role": "user", "content": "Review my code."}]
}

Streaming vs. no streaming

Configura stream: true para recibir tokens a medida que se generan, igual que el formato de streaming de OpenAI (Server-Sent Events, terminado por [DONE]). Omítelo, o ponlo en false, para esperar la respuesta completa y recibir una sola respuesta JSON — este es el comportamiento por defecto.

Errores

Los errores siguen el formato de error de OpenAI: {"error": {"message": "...", "type": "..."}}. Un 401 significa una clave faltante, inválida o revocada. Un 400 significa que la solicitud misma no es válida — normalmente un modelo no reconocido, un slug de persona no publicado/desconocido, o un modelo fuera de la lista permitida de tu clave. Un 502 significa que ningún modelo candidato respondió.

{
  "error": {
    "message": "This API key may only use: llama-3.1-8b:free",
    "type": "invalid_request_error"
  }
}

Límites de frecuencia

Las solicitudes a la API cuentan para el mismo límite de frecuencia de chat por cuenta que la aplicación web — hoy no existe una cuota separada para el tráfico de la API.