AI 生视频

用一段文字描述生成一段 1–15 秒的视频，可以带一张参考图，可以保留模型生成的声音（环境声、音效等）。

按秒计价，分 768p、480p 两档；创建任务时按时长预扣，出片失败全额退回。
结果视频带 AI 生成内容隐式标识（文件元数据 TC260:AIGC），见「AI 生成内容标识」。
生成一条通常要几分钟。

创建任务

基本信息

项目	值
请求方法	`POST`
请求路径	`/task/video_generate`
Content-Type	`application/json`
鉴权方式	`Authorization` 请求头（直接传 API Key）

请求参数（Body）

参数名	类型	必填	默认值	说明
`prompt`	`string`	是	—	画面、动作、镜头运动与声音的描述，去掉首尾空白后 1–5000 个字符
`image_file_id`	`string`	否	—	参考图：一个已上传图片的文件 ID（png / jpg / jpeg / webp）。用法见参考图
`duration`	`integer`	否	`5`	时长（秒），1–15
`resolution`	`string`	否	`768p`	分辨率：`768p` / `480p`，决定单价，见计价
`aspect_ratio`	`string`	否	见说明	画幅：`16:9` / `9:16`。不传时，带了参考图就按参考图的宽高比取最近一档，否则为 `16:9`
`audio`	`boolean`	否	`true`	是否保留模型生成的声音；`false` 时去掉音轨
`engine`	`string`	否	`h3`	引擎，目前只有 `h3`

请求示例

只用文字：

curl -X POST https://api.ai-mcn.tv:10000/task/video_generate \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A paper boat drifting down a rainy street at night, slow dolly in, soft rain sound", "duration": 5}'

带参考图（先用「上传文件」拿到图片的 file_id）：

curl -X POST https://api.ai-mcn.tv:10000/task/video_generate \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "The bronze statue stands among green trees, a breeze moves the leaves, the camera slowly pushes in", "image_file_id": "537489015178246", "duration": 6, "resolution": "480p"}'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "video_generate",
    "status": "queued"
  }
}

resolution 为 480p 时 task_type 为 video_generate_480p；两档都用同一个查询接口。

查询任务结果

基本信息

项目	值
请求方法	`GET`
请求路径	`/task/video_generate/{task_id}`
鉴权方式	`Authorization` 请求头（直接传 API Key）

响应参数（output_result）

参数名	类型	说明
`file_id`	`string`	视频文件 ID
`download_url`	`string`	视频下载路径（mp4）
`duration`	`number`	实测时长（秒）
`width` / `height`	`integer`	实测宽高
`has_audio`	`boolean`	视频是否带音轨
`engine`	`string`	本单的引擎
`resolution`	`string`	本单的分辨率
`aspect_ratio`	`string`	实际用的画幅（没传时为缺省值或按参考图取的值）

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "download_url": "/download/a1/output.mp4",
      "duration": 5.04,
      "width": 1344,
      "height": 768,
      "has_audio": true,
      "engine": "h3",
      "resolution": "768p",
      "aspect_ratio": "16:9"
    },
    "create_time": "2026-11-11T08:00:00Z",
    "update_time": "2026-11-11T08:04:10Z"
  }
}

参考图

参考图决定画面的主体、构图与风格。提示词照着这张图的画面写（只写从这一帧出发的动作、镜头运动和声音），视频第一帧就是这张图的同一画面，但不保证逐像素一致。
提示词描述的场景与参考图冲突时，画面以提示词为准，第一帧可能完全不像参考图。
参考图的宽高比最好与 aspect_ratio 一致（16:9 或 9:16）；不一致时画面会被裁切。

计价

分辨率	单价	5 秒一条
`768p`	每秒 90 积分	450 积分
`480p`	每秒 60 积分	300 积分

计量单位是「秒」，价格页显示的就是上表的每秒单价。
创建任务时按 duration 预扣；出片失败（含未通过内容审核）全额退回。
不设免费次数，不进额度包，只扣余额。

数据去向

提示词与参考图由境内的第三方视频生成模型服务处理。

错误码

业务码	HTTP	含义	处理
`6016`	400	参数取值不合法（`prompt` 为空或过长、`duration` / `resolution` / `aspect_ratio` / `audio` / `engine` 越界、`image_file_id` 不是字符串）	不建任务、不扣费；按文案改参数
`FILE_NOT_FOUND`	400	参考图文件不存在	不建任务、不扣费
`TYPE_NOT_MATCH`	400	参考图不是 png / jpg / jpeg / webp	不建任务、不扣费
`6065`	—	提示词或参考图未通过模型服务的内容审核（任务失败时返回）	积分全额退回；调整提示词或参考图后重试

使用约束

不得用于生成仿冒他人身份、侵犯他人权益或违反法律法规的内容。
公开发布生成的视频时，请按平台要求标注「AI 生成」。