API de Colora
La API es la propia API /v1 de la app abierta a claves API: las mismas páginas, personajes, libros, créditos y límites. Las claves API están incluidas en los planes Creator y Pro. Los asistentes de IA deben usar el conector MCP en su lugar.
- URL base:
https://colora-api.norvane-studio.com - OpenAPI 3.1: /openapi.json
- MCP:
https://colora-api.norvane-studio.com/mcp(OAuth)
Autenticación
Crea una clave en la app en Cuenta → Claves API y envíala como token bearer:
curl https://colora-api.norvane-studio.com/v1/me \
-H "Authorization: Bearer co_live_..."Crear un dibujo
curl -X POST https://colora-api.norvane-studio.com/v1/pages \
-H "Authorization: Bearer co_live_..." -H "Content-Type: application/json" \
-d '{"subject": "un dragón amigable leyendo un libro", "level": "kids", "aspect": "3:4"}'La respuesta es 202 Accepted con el dibujo en cola y un encabezado Location. Consulta GET /v1/pages/{id} cada 2 segundos hasta que status sea succeeded (entonces imageUrl es un enlace de 15 minutos al PNG) o failed (el crédito se devuelve). Un dibujo tarda unos 5 segundos. La misma solicitud dentro de 2 minutos devuelve el mismo dibujo sin cobrar de nuevo.
Endpoints
| Método y ruta | Qué hace | Coste |
|---|---|---|
POST /v1/pages | Un dibujo a partir de una descripción (subject, level, aspect, frame, characterId, count 1–4) | 1 crédito por dibujo |
POST /v1/pages/photo | Un dibujo basado en una foto subida con /v1/files | 1 crédito |
POST /v1/ideas | Ideas de dibujos para un tema | Gratis (límite diario) |
POST /v1/pages/batch | Un dibujo por idea (Creator 10, Pro 50 por solicitud) | 1 crédito por dibujo |
GET /v1/pages, GET /v1/pages/{id} | La biblioteca; un dibujo | Gratis |
POST /v1/pages/{id}/edit, /again | Un cambio en las palabras; otra versión | 1 crédito |
GET /v1/pages/{id}/download, /versions; DELETE /v1/pages/{id} | Enlace de descarga; versiones; eliminar | Gratis |
GET/POST /v1/characters | Lista; guardar un personaje de un dibujo | Gratis |
GET /v1/books, GET /v1/books/{id} | Libros y enlaces firmados a sus páginas | Gratis |
POST /v1/files/upload-url, /confirm | Subir una foto directamente al almacenamiento | Gratis |
Niveles: kids, medium, detailed. Proporciones: 3:4 (Letter, A4), 4:5 (8×10), 2:3 (6×9), 1:1, 4:3. Pon las palabras entre comillas en el tema para que aparezcan con letras en el dibujo.
Límites y errores
1.200 solicitudes por hora y clave, sondeo incluido; cada respuesta incluye los encabezados RateLimit-Policy y RateLimit, y un 429 tiene Retry-After. Los errores son JSON: {"error": "no_credits", "message": "..."}. Códigos comunes: no_credits (402), plan_required (403), content_refused (422), capacity (503).
El PDF y el SVG se generan en el dispositivo en la app; a través de la API obtienes el PNG (aproximadamente 1 megapíxel).