API 接口文档

Base URL：https://aivideomaker.ai

认证方式

所有请求需要在请求头中传递 API Key：

请求头	必填	说明
key	是	你的 API Key

---

接口列表

1. 创建生成任务

POST /api/v1/generate/{model}

创建视频生成任务，返回任务 ID 和查询/取消链接。

请求头

请求头	必填	说明
key	是	你的 API Key
webhookUrl	否	回调地址，任务状态变更时通知

路径参数

参数	必填	可选值
model	是	t2v / i2v / lv / t2v_v3 / i2v_v3

---

各模型参数

t2v — 文生视频

字段	类型	必填	说明
prompt	string	是	文本提示词
aspectRatio	string	是	16:9 / 9:16 / 1:1
duration	string	是	5 或 8（秒）

积分消耗： 时长 × 1

请求示例

POST /api/v1/generate/t2v

{
  "prompt": "一段夕阳下未来城市天际线的电影感镜头",
  "aspectRatio": "16:9",
  "duration": "8"
}

---

i2v — 图生视频

字段	类型	必填	说明
image	string	是	公网图片 URL 或 data:image/...;base64,...
prompt	string 或 null	否	可选提示词
duration	string	是	5 或 8（秒）

积分消耗： 时长 × 1

---

lv — 长视频

字段	类型	必填	说明
image	string	是	首帧图片 URL 或 data:image/...;base64,...
prompt	string[]	是	分段提示词数组，最多 6 条

积分消耗： 提示词条数 × 5 × 15

视频时长自动计算：每条提示词 = 5 秒。

---

t2v_v3 — 文生视频 V3

字段	类型	必填	说明
prompt	string	是	文本提示词
aspectRatio	string	是	16:9 / 9:16 / 1:1
duration	string	是	5 / 10 / 15 / 20（秒）

积分消耗： 时长 × 10

---

i2v_v3 — 图生视频 V3

字段	类型	必填	说明
image	string	是	公网图片 URL 或 data:image/...;base64,...
prompt	string 或 null	否	可选提示词
duration	string	是	5 / 10 / 15 / 20（秒）

积分消耗： 时长 × 10

---

成功响应示例

{
  "status": "SUBMITTED",
  "taskId": "ckxxxxxxxx",
  "responseUrl": "https://aivideomaker.ai/api/v1/tasks/ckxxxxxxxx",
  "statusUrl": "https://aivideomaker.ai/api/v1/tasks/ckxxxxxxxx/status",
  "cancelUrl": "https://aivideomaker.ai/api/v1/tasks/ckxxxxxxxx/cancel"
}

错误响应示例

{
  "status": "FAILED",
  "message": "Insufficient credits"
}

---

2. 查询任务列表

GET /api/v1/tasks

返回当前 API Key 下的所有任务，按创建时间倒序。

响应示例

{
  "tasks": [
    {
      "id": "ckxxxxxxxx",
      "createdAt": "2026-03-19T08:00:00.000Z",
      "model": "t2v",
      "input": { "prompt": "...", "aspectRatio": "16:9" },
      "output": null,
      "status": "PROGRESS",
      "completedAt": null
    }
  ]
}

---

3. 查询任务详情

GET /api/v1/tasks/{taskId}

返回任务完整信息，包含输入参数、输出结果、状态和完成时间。

---

4. 查询任务状态

GET /api/v1/tasks/{taskId}/status

仅返回任务当前状态，适合轮询。

响应示例

{
  "status": "COMPLETED"
}

---

5. 取消任务

PUT /api/v1/tasks/{taskId}/cancel

取消任务。仅在任务处于 SUBMITTED 状态时可取消。

---

任务状态值

状态	说明
SUBMITTED	任务已提交，等待处理
PROGRESS	任务处理中
COMPLETED	任务已完成
FAILED	任务失败（积分自动退还）
CANCEL	任务已取消

限流

任务查询类接口限流 60 次/分钟/IP。超出后返回 HTTP 429，响应头包含 Retry-After。