创建异步视频任务

POST

/v1/videos

使用 model=ima-pro 或 model=ima-pro-fast 提交任务。

常用字段：

文本：prompt

图片：images（支持多图）

参考视频：metadata.reference_video_urls

参考音频：metadata.reference_audio_urls

组合逻辑（对齐 New API 当前行为）：

文本（prompt 必填）

文本 + 图片（prompt 可选）

文本 + 视频（prompt 可选）

文本 + 图片 + 音频（prompt 可选）

文本 + 图片 + 视频（prompt 可选）

文本 + 视频 + 音频（prompt 可选）

文本 + 图片 + 视频 + 音频（prompt 可选）

下方示例是请求体，不是返回体。

请求参数

Body 参数application/json必填

{
    "model": "ima-pro-fast",
    "prompt": "清晨城市延时摄影，暖色调，电影感。",
    "duration": 5
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/videos' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "ima-pro-fast",
    "prompt": "清晨城市延时摄影，暖色调，电影感。",
    "duration": 5
}'

返回响应

🟢200成功

application/json

任务提交成功

Body

示例

{
    "id": "task_202603131631387ETKUBM91MTD72X9",
    "task_id": "task_202603131631387ETKUBM91MTD72X9",
    "object": "video",
    "model": "ima-pro",
    "status": "",
    "progress": 0,
    "created_at": 1773395498
}

🟠400请求有误

🟠401没有权限

修改于 2026-03-13 13:55:54

查询任务状态与结果