视频生成 API

概览

异步流程：先 POST 创建任务拿到 task_id，再 GET 轮询直至 completed 或 failed。创建接口返回精简结果；查询接口返回标准化的视频任务对象。

鉴权

所有请求需在 Header 携带 API key，可使用任一形式：

Authorization: Bearer ak_...
X-API-Key: ak_...

模型

八个模型共用同一套基础请求体结构。`-x` 表示海外线路版本，`-omni` 表示视频参考 SKU；不带 `-omni` 的模型只适合标准文本/图片参考场景。

• animevideo-2.0-pro：质量优先
• animevideo-2.0-fast：速度优先
• animevideo-2.0-pro-x：海外版质量优先
• animevideo-2.0-fast-x：海外版速度优先
• animevideo-2.0-pro-omni：标准线路视频参考版（质量优先）
• animevideo-2.0-fast-omni：标准线路视频参考版（速度优先）
• animevideo-2.0-pro-omni-x：海外线路视频参考版（质量优先）
• animevideo-2.0-fast-omni-x：海外线路视频参考版（速度优先）

上传参考视频

POST https://animemodel.ai/api/v1/reference-video/upload

参考视频建议先上传到 AnimeModel，再把返回的 url 放进 reference_video_urls。上传接口接收 multipart 文件；如果你同时传了 duration，且视频比目标时长更长，服务端会自动裁前 N 秒后再返回 URL。

当前支持 mp4 和 mov，文件大小上限为 50MB。

POST https://animemodel.ai/api/v1/reference-video/upload
Authorization: Bearer ak_xxxxxxxxxxxxxxxx
Content-Type: multipart/form-data

file=<reference-video.mp4>
duration=5

{
  "success": true,
  "url": "https://animemodel.ai/videos/user/reference-inputs/xxx.mp4",
  "object_key": "videos/user/reference-inputs/xxx.mp4",
  "mime_type": "video/mp4",
  "duration": 5,
  "width": 720,
  "height": 1280,
  "trimmed": true
}

创建异步视频任务

POST https://animemodel.ai/api/v1/videos

请求体使用顶层字段，不使用嵌套 metadata。仅「纯文本」场景下 prompt 必填；带图、带参考音视频等组合时可省略。

如果切换到 animevideo-2.0-pro-x 或 animevideo-2.0-fast-x， 除了 `model` 取值不同之外，其余请求字段与标准版完全一致。

`-omni` 模型专门用于带 reference_video_urls 的任务。建议先通过 /api/v1/reference-video/upload 上传参考视频，再把返回 URL 填进创建请求。使用 `-omni` 时必须提供参考视频，且 duration 只支持 5、10、15 秒。

POST https://animemodel.ai/api/v1/videos
Authorization: Bearer ak_xxxxxxxxxxxxxxxx

{
  "model": "animevideo-2.0-fast-omni",
  "prompt": "清晨城市延时摄影，暖色调，电影感。",
  "reference_video_urls": [
    "https://example.com/reference.mp4"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}

{
  "success": true,
  "task_id": "task_202603131631387ETKUBM91MTD72X9",
  "status": "PENDING"
}

查询任务状态与结果

GET https://animemodel.ai/api/v1/videos/{task_id}

使用创建接口返回的 task_id 轮询。成功时 results 内为视频 URL 列表；失败时会在 error.message 返回清洗后的错误信息。查询结果里的 model 固定返回 animemodel，不会回显具体 SKU。

{
  "id": "task_202603131631387ETKUBM91MTD72X9",
  "task_id": "task_202603131631387ETKUBM91MTD72X9",
  "object": "video",
  "model": "animemodel",
  "status": "in_progress",
  "progress": 42,
  "created_at": "2026-03-31T10:12:00Z"
}

{
  "id": "task_202603131631387ETKUBM91MTD72X9",
  "task_id": "task_202603131631387ETKUBM91MTD72X9",
  "object": "video",
  "model": "animemodel",
  "status": "completed",
  "progress": 100,
  "created_at": "2026-03-31T10:12:00Z",
  "completed_at": "2026-03-31T10:14:30Z",
  "results": [
    {
      "url": "https://animemodel.ai/videos/example.mp4",
      "content_type": "video/mp4",
      "width": 864,
      "height": 496,
      "duration": 5
    }
  ]
}

输入组合

1. 文本（prompt 必填）
2. 文本 + 图片（image_url 或 image_urls，prompt 可选）
3. 文本 + 视频（reference_video_urls，需使用 `-omni` 模型）
4. 文本 + 图片 + 音频（image_url/image_urls + reference_audio_urls）
5. 文本 + 图片 + 视频（image_url/image_urls + reference_video_urls，需使用 `-omni` 模型）
6. 文本 + 视频 + 音频（reference_video_urls + reference_audio_urls，需使用 `-omni` 模型）
7. 文本 + 图片 + 视频 + 音频（三者俱全，需使用 `-omni` 模型）

默认 role_mode=reference 时图片按参考图处理； role_mode=frame 模式下单图为首帧、双图为首尾帧，且不能与参考音视频混用。

非 `-omni` 模型不接受 reference_video_urls；`-omni` 模型必须带参考视频。

常用字段

• aspect_ratio：16:9、4:3、1:1、3:4、9:16、21:9、adaptive
• resolution：480p、720p
• duration：4–15 秒
• framespersecond：12–60
• image_url / image_urls：支持单图或多图 URL 输入
• reference_video_urls：最多 3 条
• reference_audio_urls：最多 3 条
• role_mode：reference 或 frame
• audio：是否生成音频