Endpoint · Video

Video Generation

视频生成走异步任务模式：先创建任务，轮询状态，完成后拿到 mp4 链接。整个流程一个端点 + 一次轮询解决。

端点

http
POST  https://api.aicodedog.com/v1/videos/generations    # 创建任务
GET   https://api.aicodedog.com/v1/videos/generations/{id}  # 查任务

常用模型：veo3-1-lite（Google）、wan2-7（阿里）、douban-seedance-1-lite（字节）、vidu-q1-lite（生数）、skyreels-v4-fast（昆仑）。

创建任务

curl
curl https://api.aicodedog.com/v1/videos/generations \
  -H "Authorization: Bearer $AICODEDOG_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2-7",
    "prompt": "一只橘猫在阳光下打哈欠，特写镜头，8 秒",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

响应给出任务 ID：

json
{
  "id": "vidgen_abc123",
  "status": "queued",
  "model": "wan2-7",
  "created": 1747291200
}

轮询状态

curl
curl https://api.aicodedog.com/v1/videos/generations/vidgen_abc123 \
  -H "Authorization: Bearer $AICODEDOG_KEY"

状态机：

queued → 排队中
processing → 生成中（占 80% 时间）
succeeded → 完成，video_url 字段可用
failed → 失败，error 字段含原因

json
{
  "id": "vidgen_abc123",
  "status": "succeeded",
  "video_url": "https://cdn.aicodedog.com/video/abc123.mp4",
  "thumbnail_url": "https://cdn.aicodedog.com/video/abc123.jpg",
  "duration": 8,
  "completed": 1747291320
}

建议轮询间隔

首 30 秒每 5s 查一次，之后每 10s 一次。绝大多数任务在 30s–120s 内完成；超过 5 分钟极可能是失败，及时取消重试。

图生视频

支持的模型（如 wan2-7-e2v、vidu1）会接受 image_url 作为首帧或参考：

json
{
  "model": "wan2-7-e2v",
  "image_url": "https://example.com/keyframe.jpg",
  "prompt": "镜头缓慢拉远，背景光线变得柔和",
  "duration": 6
}

参数

model（必填）— 模型 slug。
prompt（必填）— 文字描述。
duration — 时长（秒），常用 4 / 6 / 8 / 12 / 15。
aspect_ratio — 16:9 / 9:16 / 1:1 / 4:3。
resolution — 540p / 720p / 1080p。
image_url — 图生视频时的首帧/参考图。
seed — 复现性 seed（best-effort）。
negative_prompt — 负面提示词。

计费在任务完成时扣

创建任务时不扣费。任务进入 succeeded 时按时长 + 模型扣账户余额。failed 任务**不计费**。