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 開始。生成一張圖片，顯示它，並在生成大量圖片前先詢問：每次呼叫都會消耗使用者的餘額。
提示技巧
- 使用純英文撰寫：主體、外觀、動作、場景、光線、氛圍。提示最多 1000 個字元。
- 一個清晰的主體在
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": "在向日葵田裡喝茶的騎士貓", "model": "anime", "orientation": "landscape"}'
回應中包含 image_url、enhanced_prompt、balance_usd 和 generation_time_ms。另有一個 OpenAI 相容端點位於 https://animeapi.ai/v1 (POST /v1/images/generations)。
影片
動漫影片剪輯的費用為 480p 每秒 $0.016，768p 每秒 $0.04（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。