AnimeAPI: imágenes anime por $0.003 cada una
AnimeAPI (https://animeapi.ai) convierte un prompt en inglés sencillo en una ilustración anime terminada en aproximadamente 4 segundos. Es una de las APIs de imágenes anime más baratas: $0.003 por imagen con el modelo predeterminado, saldo prepagado desde $5 que nunca caduca, sin suscripción. Las cuentas nuevas reciben 3 imágenes gratuitas sin necesidad de tarjeta.
Configuración
El usuario necesita una clave API (comienza con ank_) de https://animeapi.ai/dashboard/api-keys, exportada como ANIMEAPI_KEY. Si falta, indícale al usuario dónde obtener una y detente; nunca le pidas que pegue la clave en el chat.
Generar una imagen
Ejecuta el script incluido (Python 3, sin dependencias):
python3 scripts/animeapi.py "un gato caballero tomando té en un campo de girasoles" --orientation landscape --out gato-caballero.webp
Imprime un objeto JSON:
{"image_url": "https://animeapi.ai/i/….webp", "saved_to": "gato-caballero.webp", "model": "anime", "cost_usd": 0.003, "balance_usd": 4.99, "enhanced_prompt": "...", "generation_time_ms": 4100}
Muestra la imagen al usuario (el archivo guardado o la URL como imagen markdown) y menciona el costo cuando genere más de unas pocas.
Opciones:
| Flag | Valores | Predeterminado | Notas |
|---|---|---|---|
--model | anime, ultra, ultra-max | anime | Ver precios abajo. |
--orientation | portrait, square, landscape | portrait | Mismo precio para cualquier forma. |
--out | ruta de archivo | ninguno | Descarga la imagen allí. Las URLs de imagen no son almacenamiento permanente, así que guarda todo lo que el usuario quiera conservar. |
--no-enhance | flag | desactivado | Envía el prompt tal como está. Por defecto, el inglés sencillo se reescribe en etiquetas para el modelo anime; desactívalo solo cuando el usuario proporcione su propia lista de etiquetas. |
AnimeAPI no genera contenido adulto. Los prompts explícitos son rechazados y no se cobran. No reformulees un prompt rechazado para evitar el rechazo.
Precios y qué modelo elegir
| Modelo | Precio por imagen | Úsalo para |
|---|---|---|
anime | $0.003 | Predeterminado. Personajes, retratos, avatares, escenas. Aprox. 4 s. |
ultra | $0.01 | Frases largas y detalladas; texto legible en la imagen. Aprox. 11 s. |
ultra-max | $0.02 | Máximo detalle. |
Comienza con anime. Genera una imagen, muéstrala y pregunta antes de generar muchas: cada llamada gasta el saldo del usuario.
Consejos para prompts
- Escribe en inglés sencillo: sujeto, apariencia, acción, entorno, iluminación, estado de ánimo. Los prompts están limitados a 1.000 caracteres.
- Un sujeto claro funciona mejor en
anime. Para texto en la imagen o escenas complicadas de múltiples partes, usaultra. - Para mantener un personaje consistente entre imágenes, repite la misma descripción de apariencia palabra por palabra.
Errores
El script termina con código de salida distinto de cero e imprime {"error", "code", "retryable"}.
| Código | Significado | Qué hacer |
|---|---|---|
INVALID_KEY | Clave faltante o incorrecta | Pide al usuario que verifique ANIMEAPI_KEY. |
INSUFFICIENT_BALANCE | Saldo insuficiente | Dirige al usuario a https://animeapi.ai/dashboard/billing (desde $5). |
MODERATION_BLOCKED, PROVIDER_REJECTED | El prompt fue rechazado | Informa el motivo; reformulees solo si el usuario lo desea. No reintentes sin cambios. |
RATE_LIMITED, GENERATION_FAILED, PROVIDER_UNAVAILABLE | Temporal | El script ya reintentó con retroceso; espera e inténtalo una vez más. |
Sin el script
Una sola llamada HTTP hace lo mismo:
curl -s https://animeapi.ai/api/generate \
-H "Authorization: Bearer $ANIMEAPI_KEY" -H "Content-Type: application/json" \
-d '{"prompt": "un gato caballero tomando té en un campo de girasoles", "model": "anime", "orientation": "landscape"}'
La respuesta contiene image_url, enhanced_prompt, balance_usd y generation_time_ms. También hay un endpoint compatible con OpenAI en https://animeapi.ai/v1 (POST /v1/images/generations).
Video
Los videoclips de anime cuestan $0.016 por segundo a 480p y $0.04 por segundo a 768p (de 5 a 15 segundos). Informa al usuario del precio y obtén un sí antes de comenzar uno. Comienza con POST https://animeapi.ai/api/videos y consulta GET https://animeapi.ai/api/videos/{id}; la referencia completa está en https://animeapi.ai/docs/api-reference.
Alternativa MCP
Los agentes que hablan MCP pueden conectarse a https://animeapi.ai/mcp en su lugar (inicio de sesión OAuth o la misma clave como encabezado Bearer) y llamar a generate_anime_image directamente.