Autenticación
Crea claves de API, envíalas en cada solicitud y entiende los permisos y endpoints.
Clave de API
Crea claves en la consola con un nombre y una caducidad, incluida la opción sin caducidad. Las claves nuevas incluyen todos los permisos estándar de la API y pueden verse de nuevo tras iniciar sesión. Nunca pongas claves en código del lado del cliente ni en repositorios públicos.
| Permiso | Permite |
|---|---|
jobs:create | Enviar tareas |
jobs:read | Consultar y listar tareas |
media:write | Subir imágenes o vídeos de entrada |
media:read | Descargar archivos de resultado |
usage:read | Leer créditos e historial |
chat:create | Call chat completions |
Envía la clave
Envía la clave como Authorization: Bearer <key> o x-api-key: <key> — no ambos. La consola web y el playground usan tu sesión iniciada.
Una clave ausente o no válida devuelve 401 AUTH_REQUIRED; una clave sin el permiso necesario devuelve 403 INSUFFICIENT_SCOPE.
Endpoints
| Método | Ruta | Finalidad | Autenticación |
|---|---|---|---|
GET | /api/v1/models | Lista el catálogo público de modelos | Pública |
GET | /api/v1/models/{slug} | Un modelo con su esquema de entrada | Pública |
GET | /api/v1/prices | Precios por tarea configurados (micro-unidades de USD) | Pública |
POST | /api/v1/media | Sube bytes de imagen o vídeo y devuelve media:<uuid> | media:write |
POST | /api/v1/jobs | Envía una tarea asíncrona de modelo | jobs:create |
GET | /api/v1/jobs/{id} | Consulta el estado y los resultados de una tarea | jobs:read |
GET | /api/v1/jobs | Tus últimas 100 tareas | jobs:read |
GET | /api/v1/results/{id} | Descarga un archivo de resultado propio | media:read |
GET | /api/v1/usage | Saldo de créditos e historial reciente | usage:read |
GET | /api/v1/chat/models | Callable chat models with token prices (OpenAI list format) | Pública |
POST | /api/v1/chat/completions | OpenAI-compatible chat completion, billed per token | chat:create |
GET | /api/v1/chat/requests | Your chat requests with charges, limit (1–100) and before cursor | usage:read |
GET | /api/v1/chat/requests/{id} | One chat request belonging to your account | usage:read |
Agentes de IA
Los agentes de IA pueden iniciar sesión con OAuth a través del servidor MCP en lugar de usar una clave. MCP y Skill