API Colora
L'API est l'API interne /v1 de l'application ouverte aux clés API : les mêmes pages, personnages, livres, crédits et limites. Les clés API sont disponibles avec les plans Creator et Pro. Les assistants IA doivent utiliser le connecteur MCP à la place.
- URL de base :
https://colora-api.norvane-studio.com - OpenAPI 3.1 : /openapi.json
- MCP :
https://colora-api.norvane-studio.com/mcp(OAuth)
Authentification
Créez une clé dans l'application sous Compte → Clés API et envoyez-la comme token bearer :
curl https://colora-api.norvane-studio.com/v1/me \
-H "Authorization: Bearer co_live_..."Créer une page
curl -X POST https://colora-api.norvane-studio.com/v1/pages \
-H "Authorization: Bearer co_live_..." -H "Content-Type: application/json" \
-d '{"subject": "un dragon amical qui lit un livre", "level": "kids", "aspect": "3:4"}'La réponse est 202 Accepted avec la page en file d'attente et un en-tête Location. Interrogez GET /v1/pages/{id} toutes les 2 secondes jusqu'à ce que status soit succeeded (alors imageUrl est un lien valable 15 minutes vers le PNG) ou failed (le crédit est remboursé). Une page prend environ 5 secondes. La même requête dans les 2 minutes retourne la même page sans facturation supplémentaire.
Endpoints
| Méthode et chemin | Fonction | Coût |
|---|---|---|
POST /v1/pages | Une page à partir d'une description (subject, level, aspect, frame, characterId, count 1–4) | 1 crédit par page |
POST /v1/pages/photo | Une page tracée depuis une photo téléchargée avec /v1/files | 1 crédit |
POST /v1/ideas | Idées de pages pour un thème | Gratuit (quota quotidien) |
POST /v1/pages/batch | Une page par idée (Creator 10, Pro 50 par requête) | 1 crédit par page |
GET /v1/pages, GET /v1/pages/{id} | Bibliothèque ; une page | Gratuit |
POST /v1/pages/{id}/edit, /again | Une modification textuelle ; une autre version | 1 crédit |
GET /v1/pages/{id}/download, /versions ; DELETE /v1/pages/{id} | Lien de téléchargement ; versions ; suppression | Gratuit |
GET/POST /v1/characters | Liste ; sauvegarder un personnage depuis une page | Gratuit |
GET /v1/books, GET /v1/books/{id} | Livres et liens signés vers leurs pages | Gratuit |
POST /v1/files/upload-url, /confirm | Télécharger une photo directement dans le stockage | Gratuit |
Niveaux : kids, medium, detailed. Formats : 3:4 (US Letter, A4), 4:5 (8×10), 2:3 (6×9), 1:1, 4:3. Placez les mots entre guillemets dans le sujet pour qu'ils apparaissent en lettres sur la page.
Limites et erreurs
1 200 requêtes par heure et par clé, polling inclus ; chaque réponse inclut les en-têtes RateLimit-Policy et RateLimit, et un code 429 contient Retry-After. Les erreurs sont en JSON : {"error": "no_credits", "message": "..."}. Codes courants : no_credits (402), plan_required (403), content_refused (422), capacity (503).
Les PDF et SVG sont générés sur l'appareil dans l'application ; via l'API, vous obtenez le PNG (environ 1 mégapixel).