Llamar directamente a la API de Flatkey

URL base: https://router.flatkey.ai Flatkey expone una API REST compatible con OpenAI. Si ya tienes un cliente HTTP, no necesitas un SDK. Esta página es el camino más corto desde una clave hasta una solicitud funcional.

Autenticarse

Cada solicitud lleva tu clave como token bearer:

Authorization: Bearer YOUR_FLATKEY_API_KEY

Crea una clave en la consola. Las claves comienzan con sk-fk-. Guárdala en una variable de entorno y mantenla fuera del control de versiones y del código del navegador.

export FLATKEY_API_KEY="sk-fk-..."

Enviar una solicitud

curl --fail-with-body -sS https://router.flatkey.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{ "role": "user", "content": "Hello!" }]
  }'

Una llamada exitosa devuelve el objeto estándar de finalización de chat con choices y usage.

Endpoints disponibles

Endpoint	Propósito
`POST /v1/chat/completions`	Generación de texto y chat
`POST /v1/responses`	API de Responses, para modelos de OpenAI
`POST /v1/images/generations`	Generación y edición de imágenes
`POST /v1/videos`	Generación de vídeo, asíncrona
`GET /v1/videos/{task_id}`	Consultar el estado de una tarea de vídeo
`GET /v1/models`	Listar los modelos disponibles
`GET /v1/credits`	Saldo restante

POST /v1/responses actualmente funciona con modelos de OpenAI. Otras familias devuelven un error en este endpoint — usa POST /v1/chat/completions para ellas.

Consultar tu saldo

curl --fail-with-body -sS https://router.flatkey.ai/v1/credits \
  -H "Authorization: Bearer $FLATKEY_API_KEY"

{ "remaining": 34.18, "used": 185.13 }

Gestionar errores

Los errores devuelven un cuerpo JSON con un mensaje sobre el que puedes actuar:

{ "error": { "message": "No available channel for model ..." } }

Estado	Significado	Qué hacer
`400`	Solicitud mal formada	Lee el mensaje; indica el campo problemático
`401`	Clave no válida	Comprueba la cabecera `Authorization` y el valor de la clave
`429`	Demasiadas solicitudes	Espera y vuelve a intentarlo
`500`, `503`	Modelo o ruta no disponibles	Cambia de modelo. Reintentar con el mismo raramente lo resuelve

Lista completa en la referencia de errores.

Próximos pasos

Referencia de la API

Cada endpoint, parámetro y campo de respuesta.

Usar un SDK en su lugar

Mantén tu cliente de OpenAI o Anthropic y cambia una sola línea.

Inicio rápido

Código

Herramientas de IA populares

Generación de medios

Modelos populares

Panel

Referencia

Llamar directamente a la API de Flatkey

Autenticarse

Enviar una solicitud

Endpoints disponibles

Consultar tu saldo

Gestionar errores

Próximos pasos

Referencia de la API

Usar un SDK en su lugar

​Autenticarse

​Enviar una solicitud

​Endpoints disponibles

​Consultar tu saldo

​Gestionar errores

​Próximos pasos

Referencia de la API

Usar un SDK en su lugar

Autenticarse

Enviar una solicitud

Endpoints disponibles

Consultar tu saldo

Gestionar errores

Próximos pasos