视频生成

视频生成为异步任务：先建任务拿到 taskId，再轮询查询结果，完成后返回视频 URL。支持文生视频与图生视频（带参考图）。

1. 创建任务#

POST https://api.smartapi.cc/api/openapi/v1/generate/video/tasks

Authorization: Bearer sk-your-key-here
Content-Type: application/json

请求体#

字段	类型	必填	说明
`model`	string	是	模型标识，例如 `wan2.5`、`veo3.1`。
`prompt`	string	是	文本提示词。
`duration`	integer	否	时长（秒），取值见模型支持的时长（如 5 / 10 / 15）。
`resolution`	string	否	分辨率，如 `480P` / `720P` / `1080P`。
`ratio`	string	否	画面比例，如 `16:9` / `9:16`。
`seed`	integer	否	随机种子。
`referenceImageUrls`	array	否	参考图 URL 列表（图生视频）。
`generateAudio`	boolean	否	是否生成音频（部分模型支持，会影响计费）。

各模型支持的时长、分辨率、比例、是否支持音频等，可在模型广场的「生图/视频调用规则」标签页中以列表查看；也可在操练场的表单中查看。

curl https://api.smartapi.cc/api/openapi/v1/generate/video/tasks \
  -H "Authorization: Bearer $SMARTAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.5",
    "prompt": "海浪拍打礁石，慢动作，黄昏",
    "duration": 5,
    "resolution": "720P"
  }'

响应#

{ "taskId": "task_abc123", "status": "processing" }

2. 查询任务结果#

每 5 秒轮询一次，直到状态为终态。model 作为查询参数传入。

GET https://api.smartapi.cc/api/openapi/v1/generate/video/tasks/{taskId}?model=wan2.5

{
  "taskId": "task_abc123",
  "status": "succeeded",
  "videoUrl": "https://.../result.mp4"
}

状态归一为：submitted / processing 处理中；succeeded（或返回 videoUrl）成功；failed 失败；canceled 已取消。

3. 取消任务#

POST https://api.smartapi.cc/api/openapi/v1/generate/video/tasks/{taskId}/cancel

{ "taskId": "task_abc123", "cancelled": true }

无需手动轮询时，可在任务记录页查看所有生图/视频任务的状态、进度与结果，支持在线预览与下载。

计费#

视频模型按积分计费（不是 token），且在建任务成功时即计费。常见口径：

PER_SECOND：消耗 = 每秒积分 × 时长。
PER_SECOND_RESOLUTION：消耗 = 每秒积分 × 时长 × 分辨率倍率（不同分辨率倍率不同）。
若开启 generateAudio 且模型配置了音频倍率，则再乘以音频倍率。

各模型单价与分辨率倍率见模型广场，计费口径详见计费。