OAuth 2.1 + PKCE
在 AnimGen 登入並確認權限；之後可隨時在帳戶中心撤銷已連線應用。
AnimGen 開放 API · v1
公開測試把動畫產生能力接入你自己的產品
透過公開測試中的非同步 API 產生影片和可用於遊戲的動畫資產。電子郵件驗證後即可建立 Key，產生與網頁共用帳戶點數。
官方遠端 MCP
公開測試把 AnimGen 接入 Perplexity、Claude、Codex 等 AI 工具
透過 OAuth 授權 Perplexity 或其他相容的 MCP 客戶端使用你的 AnimGen 帳戶，無需複製 API Key。客戶端可以發現模型、上傳圖片、查詢費用、產生動畫並下載屬於你的結果。
https://api.animgen.com/mcp明確的支出保護
連線帳戶本身不會扣點數；付費產生仍須提供短期報價或明確的點數上限。
連線到 Claude
Claude 會預填 AnimGen 的伺服器名稱與 URL；授權前請檢查連線資訊和所需權限。
連線到 Perplexity
按照遠端 MCP 連接器指南操作；功能是否可用取決於 Perplexity 方案和組織設定。
API 工作流程
一次請求，完成整套動畫輸出
傳入 File ID、內聯 Base64 或公開 HTTPS 圖片地址，然後輪詢回傳的 Animation，直到進入終態。
伺服器端驗證
在 Bearer Header 中使用 ag_live_ API Key。不要把 Key 放進網頁包、移動應用或釋出後的遊戲客戶端。
預設非同步執行
建立介面回傳 202 和 Retry-After。建議約每五秒輪詢一次，重試時複用同一個 Idempotency-Key。
共用點數，帳戶級限額
API 與網頁使用同一點數餘額。註冊基礎檔為 1 併發、3 個排隊任務、每分鐘 3 次建立和 60 次其他請求；訂閱會提高這些帳戶級限額。
常用預設值
- 不傳 selection 時使用完整產生影片。
- 不傳 output_formats 時輸出 Spritesheet。
- 透明匯出只走 Alpha Key 流程；API 不對任意背景執行 AI 摳圖。
- 合規 Base64 會先持久化，再接受任務。
- 後續階段失敗時，已產生產物仍會保留。
一鍵產生 cURL
範例特意省略 selection 和 export.output_formats，以使用預設值。
curl -X POST https://api.animgen.com/v1/animations \
-H "Authorization: Bearer ag_live_REPLACE_ME" \
-H "Idempotency-Key: character-run-v1" \
-H "Content-Type: application/json" \
-d '{
"input": {
"first_frame": {
"type": "base64",
"media_type": "image/png",
"data": "<BASE64_DATA>"
}
},
"prompt": "pixel art knight running, side view",
"metadata": {"external_id": "character-run-v1"}
}'核心資源
POST
/animations一步完成影片產生與動畫匯出GET
/animations/{id}查詢狀態、點數、錯誤與輸出素材POST
/video-generations單獨產生影片預覽POST
/animation-exports單獨匯出選取的影片素材POST
/files上傳可重複使用的 PNG、JPEG 或 WebP 圖片GET
/models查看目前模型能力與可用參數高階兩階段流程
如果產品需要在產生和匯出之間進行審核或編輯，可分別呼叫 /video-generations 與 /animation-exports。
安全重試
遇到 429 或可重試的 503 時遵循 Retry-After。同一次邏輯建立請求不要更換冪等鍵。
輸出資產
Spritesheet、後設資料、PNG 影格、普通片段以及 Unity、Godot、Unreal Paper2D、Cocos Creator 引擎包都會作為可下載 Asset 回傳；透明輸出要求來源影片採用 Alpha Key 模式，商業使用仍需符合服務條款中的付費權益。