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 模式，商业使用仍需符合服务条款中的付费权益。