API do Colora
A API é a própria API /v1 do aplicativo aberta para chaves de API: as mesmas páginas, personagens, livros, créditos e limites. As chaves de API estão disponíveis nos planos Creator e Pro. Assistentes de IA devem usar o conector MCP em vez disso.
- URL base:
https://colora-api.norvane-studio.com - OpenAPI 3.1: /openapi.json
- MCP:
https://colora-api.norvane-studio.com/mcp(OAuth)
Autenticação
Crie uma chave no aplicativo em Conta → Chaves de API e envie como token bearer:
curl https://colora-api.norvane-studio.com/v1/me \
-H "Authorization: Bearer co_live_..."Criar uma página
curl -X POST https://colora-api.norvane-studio.com/v1/pages \
-H "Authorization: Bearer co_live_..." -H "Content-Type: application/json" \
-d '{"subject": "um dragão amigável lendo um livro", "level": "kids", "aspect": "3:4"}'A resposta é 202 Accepted com a página na fila e um cabeçalho Location. Consulte GET /v1/pages/{id} a cada 2 segundos até que status seja succeeded (então imageUrl é um link de 15 minutos para o PNG) ou failed (o crédito é reembolsado). Uma página leva cerca de 5 segundos. A mesma solicitação dentro de 2 minutos retorna a mesma página sem cobrar novamente.
Endpoints
| Método e caminho | O que faz | Custo |
|---|---|---|
POST /v1/pages | Uma página a partir de uma descrição (subject, level, aspect, frame, characterId, count 1–4) | 1 crédito por página |
POST /v1/pages/photo | Uma página rastreada a partir de uma foto enviada com /v1/files | 1 crédito |
POST /v1/ideas | Ideias de páginas para um tema | Grátis (limite diário) |
POST /v1/pages/batch | Uma página por ideia (Creator 10, Pro 50 por solicitação) | 1 crédito por página |
GET /v1/pages, GET /v1/pages/{id} | A biblioteca; uma página | Grátis |
POST /v1/pages/{id}/edit, /again | Uma alteração nas palavras; outra versão | 1 crédito |
GET /v1/pages/{id}/download, /versions; DELETE /v1/pages/{id} | Link para download; versões; excluir | Grátis |
GET/POST /v1/characters | Lista; salvar um personagem a partir de uma página | Grátis |
GET /v1/books, GET /v1/books/{id} | Livros e links assinados para suas páginas | Grátis |
POST /v1/files/upload-url, /confirm | Enviar uma foto diretamente para o armazenamento | Grátis |
Níveis: kids, medium, detailed. Proporções: 3:4 (Letter, A4), 4:5 (8×10), 2:3 (6×9), 1:1, 4:3. Coloque palavras entre aspas no assunto para que sejam inseridas na página.
Limites e erros
1.200 solicitações por hora por chave, incluindo polling; todas as respostas trazem os cabeçalhos RateLimit-Policy e RateLimit, e um erro 429 tem Retry-After. Erros são JSON: {"error": "no_credits", "message": "..."}. Códigos comuns: no_credits (402), plan_required (403), content_refused (422), capacity (503).
PDF e SVG são gerados no dispositivo no aplicativo; pela API, você recebe o PNG (cerca de 1 megapixel).