AnimeAPI：每张仅需 $0.003 的动漫图像
AnimeAPI（https://animeapi.ai）可将纯英文提示在约 4 秒内转化为完整的动漫插图。它是价格最便宜的动漫图像 API 之一：默认模型 每张图像仅需 $0.003，预付费余额最低 $5，永不过期，无需订阅。新用户无需绑定信用卡即可免费获得 3 张图像。
设置
用户需要一个 API 密钥（以 ank_ 开头），可从 https://animeapi.ai/dashboard/api-keys 获取，并导出为环境变量 ANIMEAPI_KEY。如果缺少该密钥，请告知用户如何获取，并停止操作；切勿要求用户将密钥粘贴到聊天中。
生成图像
运行捆绑脚本（Python 3，无需外部依赖）：
python3 scripts/animeapi.py "一只猫骑士在向日葵田里喝茶" --orientation landscape --out knight-cat.webp
脚本会输出一个 JSON 对象：
{"image_url": "https://animeapi.ai/i/….webp", "saved_to": "knight-cat.webp", "model": "anime", "cost_usd": 0.003, "balance_usd": 4.99, "enhanced_prompt": "...", "generation_time_ms": 4100}
向用户展示图像（保存的文件或作为 Markdown 图像显示的 URL），当生成多张图像时告知其花费。
选项：
| 标志 | 可选值 | 默认值 | 说明 |
|---|---|---|---|
--model | anime、ultra、ultra-max | anime | 详见下方价格表。 |
--orientation | portrait、square、landscape | portrait | 所有尺寸价格相同。 |
--out | 文件路径 | 无 | 将图像下载到该路径。图像 URL 不是永久存储，请保存用户想要保留的任何内容。 |
--no-enhance | 标志 | 关闭 | 按原样发送提示。默认情况下，纯英文提示会被重写为动漫模型的标签；仅当用户提供自己的标签列表时关闭此选项。 |
AnimeAPI 不生成成人内容。明确拒绝违规提示，且不收费。不要为了绕过拒绝而对被拒绝的提示进行重写。
价格与模型选择
| 模型 | 每张图像价格 | 适用场景 |
|---|---|---|
anime | $0.003 | 默认。角色、肖像、头像、场景。约 4 秒。 |
ultra | $0.01 | 长句、细节描述；图像中可读的文字。约 11 秒。 |
ultra-max | $0.02 | 最高细节。 |
从 anime 开始。先生成一张图像，展示给用户，并在批量生成前征求同意：每次调用都会消耗用户余额。
提示技巧
- 使用纯英文：描述主题、外观、动作、场景、光线和氛围。提示限制在 1,000 字符以内。
anime模型最适合单一清晰主题。如果图像中需要文字或复杂的多部分场景，请使用ultra。- 若要在多张图像中保持角色一致性，请逐字重复相同的外观描述。
错误处理
脚本以非零退出码结束，并输出 {"error", "code", "retryable"}。
| 错误码 | 含义 | 应对措施 |
|---|---|---|
INVALID_KEY | 密钥缺失或错误 | 请用户检查 ANIMEAPI_KEY。 |
INSUFFICIENT_BALANCE | 余额不足 | 引导用户访问 https://animeapi.ai/dashboard/billing（最低 $5）。 |
MODERATION_BLOCKED、PROVIDER_REJECTED | 提示被拒绝 | 报告原因；仅当用户要求时才重新措辞。不要直接重试原提示。 |
RATE_LIMITED、GENERATION_FAILED、PROVIDER_UNAVAILABLE | 临时性错误 | 脚本已自动重试并带有退避策略；请等待后再次尝试。 |
无脚本方式
通过一次 HTTP 调用实现相同功能：
curl -s https://animeapi.ai/api/generate \
-H "Authorization: Bearer $ANIMEAPI_KEY" -H "Content-Type: application/json" \
-d '{"prompt": "a knight cat drinking tea in a sunflower field", "model": "anime", "orientation": "landscape"}'
响应中包含 image_url、enhanced_prompt、balance_usd 和 generation_time_ms。此外，还提供了一个兼容 OpenAI 的端点：https://animeapi.ai/v1（POST /v1/images/generations）。
视频
动漫视频片段价格为 $0.016/秒（480p）和 $0.04/秒（768p），时长 5 到 15 秒。请告知用户价格，并在开始生成前获得确认。首先使用 POST https://animeapi.ai/api/videos，然后轮询 GET https://animeapi.ai/api/videos/{id}；完整参考见 https://animeapi.ai/docs/api-reference。
MCP 替代方案
支持 MCP 协议的智能体可以连接到 https://animeapi.ai/mcp（使用 OAuth 登录或相同的密钥作为 Bearer 头信息）并直接调用 generate_anime_image。