Colora API
Die API ist die eigene /v1-API der App, die für API-Schlüssel geöffnet wurde: dieselben Seiten, Charaktere, Bücher, Credits und Limits. API-Schlüssel sind in den Tarifen Creator und Pro enthalten. KI-Assistenten sollten stattdessen den MCP-Connector verwenden.
- Basis-URL:
https://colora-api.norvane-studio.com - OpenAPI 3.1: /openapi.json
- MCP:
https://colora-api.norvane-studio.com/mcp(OAuth)
Authentifizierung
Erstelle einen Schlüssel in der App unter Konto → API-Schlüssel und sende ihn als Bearer-Token:
curl https://colora-api.norvane-studio.com/v1/me \
-H "Authorization: Bearer co_live_..."Ein Ausmalbild erstellen
curl -X POST https://colora-api.norvane-studio.com/v1/pages \
-H "Authorization: Bearer co_live_..." -H "Content-Type: application/json" \
-d '{"subject": "a friendly dragon reading a book", "level": "kids", "aspect": "3:4"}'Die Antwort ist 202 Accepted mit dem in die Warteschlange gestellten Ausmalbild und einem Location-Header. Frage alle 2 Sekunden GET /v1/pages/{id} ab, bis der status succeeded ist (dann ist imageUrl ein 15-Minuten-Link zur PNG-Datei) oder failed (das Credit wird erstattet). Ein Ausmalbild dauert etwa 5 Sekunden. Dieselbe Anfrage innerhalb von 2 Minuten liefert dasselbe Ausmalbild ohne erneute Berechnung.
Endpunkte
| Methode und Pfad | Funktion | Kosten |
|---|---|---|
POST /v1/pages | Ein Ausmalbild aus einer Beschreibung (subject, level, aspect, frame, characterId, count 1–4) | 1 Credit pro Ausmalbild |
POST /v1/pages/photo | Ein Ausmalbild aus einem Foto, das mit /v1/files hochgeladen wurde | 1 Credit |
POST /v1/ideas | Ideen für Ausmalbilder zu einem Thema | Kostenlos (tägliches Kontingent) |
POST /v1/pages/batch | Ein Ausmalbild pro Idee (Creator: 10, Pro: 50 pro Anfrage) | 1 Credit pro Ausmalbild |
GET /v1/pages, GET /v1/pages/{id} | Bibliothek; ein Ausmalbild | Kostenlos |
POST /v1/pages/{id}/edit, /again | Änderung der Beschreibung; andere Version | 1 Credit |
GET /v1/pages/{id}/download, /versions; DELETE /v1/pages/{id} | Download-Link; Versionen; löschen | Kostenlos |
GET/POST /v1/characters | Liste; Charakter aus einem Ausmalbild speichern | Kostenlos |
GET /v1/books, GET /v1/books/{id} | Bücher und signierte Links zu ihren Ausmalbildern | Kostenlos |
POST /v1/files/upload-url, /confirm | Direkter Upload eines Fotos in den Speicher | Kostenlos |
Stufen: kids, medium, detailed. Formate: 3:4 (US Letter, A4), 4:5 (8×10), 2:3 (6×9), 1:1, 4:3. Setze Wörter in Anführungszeichen im Betreff, damit sie auf dem Ausmalbild als Text erscheinen.
Limits und Fehler
1.200 Anfragen pro Stunde und Schlüssel, inklusive Polling; jede Antwort enthält die Header RateLimit-Policy und RateLimit, und bei einem 429-Status wird Retry-After zurückgegeben. Fehler sind im JSON-Format: {"error": "no_credits", "message": "..."}. Häufige Fehlercodes: no_credits (402), plan_required (403), content_refused (422), capacity (503).
PDF und SVG werden in der App auf dem Gerät erstellt; über die API erhältst du die PNG-Datei (ca. 1 Megapixel).