AnimeAPI: imagens de anime por $0.003 cada
AnimeAPI (https://animeapi.ai) transforma um prompt em inglês simples em uma ilustração de anime finalizada em cerca de 4 segundos. É uma das APIs de imagem de anime mais baratas: $0.003 por imagem no modelo padrão, saldo pré-pago a partir de $5 que nunca expira, sem assinatura. Novas contas ganham 3 imagens grátis sem precisar de cartão.
Configuração
O usuário precisa de uma chave de API (começa com ank_) em https://animeapi.ai/dashboard/api-keys, exportada como ANIMEAPI_KEY. Se estiver faltando, diga ao usuário onde obter uma e pare; nunca peça para colar a chave no chat.
Gerar uma imagem
Execute o script incluído (Python 3, sem dependências):
python3 scripts/animeapi.py "um gato cavaleiro bebendo chá em um campo de girassóis" --orientation landscape --out gato-cavaleiro.webp
Ele imprime um único objeto JSON:
{"image_url": "https://animeapi.ai/i/….webp", "saved_to": "gato-cavaleiro.webp", "model": "anime", "cost_usd": 0.003, "balance_usd": 4.99, "enhanced_prompt": "...", "generation_time_ms": 4100}
Mostre a imagem ao usuário (o arquivo salvo ou a URL como uma imagem markdown) e mencione o custo quando gerar mais do que algumas.
Opções:
| Flag | Valores | Padrão | Observações |
|---|---|---|---|
--model | anime, ultra, ultra-max | anime | Veja os preços abaixo. |
--orientation | portrait, square, landscape | portrait | Mesmo preço para qualquer formato. |
--out | caminho do arquivo | nenhum | Baixa a imagem para lá. URLs de imagem não são armazenamento permanente, então salve qualquer coisa que o usuário queira manter. |
--no-enhance | flag | desligado | Envia o prompt como escrito. Por padrão, o inglês simples é reescrito em tags para o modelo anime; desligue isso apenas quando o usuário fornecer sua própria lista de tags. |
AnimeAPI não gera conteúdo adulto. Prompts explícitos são recusados e não cobrados. Não reformule um prompt recusado para contornar a recusa.
Preços e qual modelo escolher
| Modelo | Preço por imagem | Use para |
|---|---|---|
anime | $0.003 | Padrão. Personagens, retratos, avatares, cenas. Cerca de 4 s. |
ultra | $0.01 | Frases longas e detalhadas; texto legível na imagem. Cerca de 11 s. |
ultra-max | $0.02 | Maior detalhe. |
Comece com anime. Faça uma imagem, mostre-a e pergunte antes de gerar muitas: cada chamada gasta o saldo do usuário.
Dicas para prompts
- Escreva em inglês simples: assunto, aparência, ação, cenário, iluminação, clima. Os prompts são limitados a 1.000 caracteres.
- Um assunto claro funciona melhor no
anime. Para texto na imagem ou cenas complexas com várias partes, useultra. - Para manter um personagem consistente entre imagens, repita a mesma descrição de aparência palavra por palavra.
Erros
O script sai com código diferente de zero e imprime {"error", "code", "retryable"}.
| Código | Significado | O que fazer |
|---|---|---|
INVALID_KEY | Chave ausente ou incorreta | Peça ao usuário para verificar ANIMEAPI_KEY. |
INSUFFICIENT_BALANCE | Saldo muito baixo | Direcione o usuário para https://animeapi.ai/dashboard/billing (a partir de $5). |
MODERATION_BLOCKED, PROVIDER_REJECTED | O prompt foi recusado | Relate o motivo; reformule apenas se o usuário quiser. Não tente novamente sem alterações. |
RATE_LIMITED, GENERATION_FAILED, PROVIDER_UNAVAILABLE | Temporário | O script já tentou novamente com espera exponencial; espere e tente mais uma vez. |
Sem o script
Uma única chamada HTTP faz a mesma coisa:
curl -s https://animeapi.ai/api/generate \
-H "Authorization: Bearer $ANIMEAPI_KEY" -H "Content-Type: application/json" \
-d '{"prompt": "um gato cavaleiro bebendo chá em um campo de girassóis", "model": "anime", "orientation": "landscape"}'
A resposta contém image_url, enhanced_prompt, balance_usd e generation_time_ms. Há também um ponto de extremidade compatível com a OpenAI em https://animeapi.ai/v1 (POST /v1/images/generations).
Vídeo
Clipes de vídeo de anime custam $0.016 por segundo em 480p e $0.04 por segundo em 768p (5 a 15 segundos). Informe o usuário do preço e obtenha uma confirmação antes de iniciar um. Comece com POST https://animeapi.ai/api/videos e consulte com GET https://animeapi.ai/api/videos/{id}; a referência completa está em https://animeapi.ai/docs/api-reference.
Alternativa MCP
Agentes que falam MCP podem se conectar a https://animeapi.ai/mcp diretamente (login OAuth ou a mesma chave como cabeçalho Bearer) e chamar generate_anime_image diretamente.