统一视频生成任务创建

统一视频接口用于通过同一入口创建不同视频模型的生成任务。

适用场景

希望使用统一请求结构接入 Wanxiang、HappyHorse、Seedance 等视频模型时使用该接口。不同模型支持的尺寸、时长和素材结构不同，选择模型后仍需遵守对应模型的参数限制。

Base URL

https://vip.xmsmartlink.com

鉴权

Authorization: Bearer YOUR_API_KEY

Endpoint

POST /v1/video/generations

参数说明

移动端可横向滑动查看完整参数。

参数	类型	必填	说明
`model`	string	是	视频模型名称。
`prompt`	string	是	视频提示词。
`size`	string	否	输出尺寸或分辨率档位。
`duration`	number	否	视频时长。
`ratio`	string	否	Seedance 等模型使用的输出比例。
`resolution`	string	否	输出分辨率。
`generate_audio`	boolean	否	Seedance 是否生成音频。
`seed`	number	否	随机种子。
`camera_fixed`	boolean	否	是否固定镜头。
`watermark`	boolean	否	是否添加水印。
`content`	array	否	Seedance 等模型使用的多模态内容。
`metadata`	object	否	Wanxiang、HappyHorse 等模型使用的扩展参数。

请求示例

下面使用 OpenAPI 中的 Wanxiang 文生视频字段结构：

bash

curl -X POST 'https://vip.xmsmartlink.com/v1/video/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "wan2.7-t2v",
    "prompt": "一段紧张刺激的侦探追查故事，展现电影级叙事能力。",
    "size": "720P",
    "duration": 15,
    "metadata": {
      "ratio": "16:9",
      "prompt_extend": true,
      "watermark": false
    }
  }'

响应示例

任务创建成功后保存 task_id。status: queued 表示任务已进入队列，不代表视频已经生成完成。

json

{
  "id": "task_abc123xyz",
  "task_id": "task_abc123xyz",
  "model": "wan2.7-t2v",
  "status": "queued",
  "progress": 0,
  "created_at": 1712832000,
  "object": "video"
}

错误与重试

400：检查模型名称、必填字段和该模型支持的扩展参数。
401：检查 Bearer Token。
500 或创建请求超时：请求可能已被服务端受理；先从响应和业务记录确认是否已有任务 ID，再决定是否重新创建。
本接口没有 callback_url 参数，不要等待回调；创建成功后通过查询接口读取状态，并按异步任务指南保存结果。

API Reference

查看底层接口定义

统一视频生成任务创建 ​

适用场景 ​

Base URL ​

鉴权 ​

Endpoint ​

参数说明 ​

请求示例 ​

响应示例 ​

错误与重试 ​

API Reference ​