01-3.0Pro视频生成
3.0 Pro 视频生成
文档版本：v1.0.0 | 最后更新：2026-06-11 本平台已完整适配即梦系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。
提交任务
POST https://platform.shuyanai.com/jimeng?Action=CVSync2AsyncSubmitTask&Version=2022-08-31请求头
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Content-Type | string | 是 | application/json | 数据交换格式 |
Authorization | string | 是 | 鉴权信息，参考接口鉴权 |
请求体
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
req_key | string | 是 | jimeng_ti2v_v30_pro | 服务标识，固定值：jimeng_ti2v_v30_pro |
binary_data_base64 | array of string | 条件必填 | 图片文件 Base64 编码，仅支持 1 张图片，仅支持 JPEG、PNG 格式 图片大小最大 4.7MB；分辨率最大 4096×4096，最短边不低于 320；长短边比例在 3 以内 图生视频场景图片和 prompt 二选一必填； binary_data_base64 和 image_urls 二选一 | |
image_urls | array of string | 条件必填 | 图片文件 URL，仅支持 1 张图片 图片大小最大 4.7MB；分辨率最大 4096×4096，最短边不低于 320；长短边比例在 3 以内 图生视频场景图片和 prompt 二选一必填； binary_data_base64 和 image_urls 二选一 | |
prompt | string | 条件必填 | 视频生成提示词，中英文均可。建议 400 字以内，不超过 800 字 文生视频场景必填；图生视频场景，图片和 prompt 二选一必填 | |
seed | int | 否 | -1 | 随机种子，默认 -1（随机）。相同正整数种子且其他参数一致时，生成结果极大概率一致 |
frames | int | 否 | 121 | 生成总帧数（帧数 = 24 × n + 1，n 为秒数，支持 5s / 10s） 可选值： 121 (5s), 241 (10s) |
aspect_ratio | string | 否 | 16:9 | 生成视频宽高比（仅文生视频场景生效；图生视频场景根据输入图自动匹配最接近的比例） 可选值： 16:9, 4:3, 1:1, 3:4, 9:16, 21:9对应分辨率：2176×928 (21:9)、1920×1088 (16:9)、1664×1248 (4:3)、1440×1440 (1:1)、1248×1664 (3:4)、1088×1920 (9:16) |
请求示例
curl --request POST \
--url 'https://platform.shuyanai.com/jimeng?Action=CVSync2AsyncSubmitTask&Version=2022-08-31' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"req_key": "jimeng_ti2v_v30_pro",
"image_urls": [
"https://example.com/image1.jpg"
],
"prompt": "千军万马",
"seed": -1,
"frames": 121,
"aspect_ratio": "16:9"
}'响应示例
{
"code": 10000,
"data": {
"task_id": "7392616336519610409"
},
"message": "Success",
"request_id": "20240720103939AF0029465CF6A74E51EC",
"time_elapsed": "104.852309ms"
}查询任务
POST https://platform.shuyanai.com/jimeng?Action=CVSync2AsyncGetResult&Version=2022-08-31请求头
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Content-Type | string | 是 | application/json | 数据交换格式 |
Authorization | string | 是 | 鉴权信息，参考接口鉴权 |
请求体
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
req_key | string | 是 | jimeng_ti2v_v30_pro | 服务标识，固定值：jimeng_ti2v_v30_pro |
task_id | string | 是 | 任务 ID，取自提交任务接口的返回值 | |
req_json | string | 否 | JSON 序列化字符串，支持 AIGC 隐式水印配置 |
请求示例
curl --request POST \
--url 'https://platform.shuyanai.com/jimeng?Action=CVSync2AsyncGetResult&Version=2022-08-31' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"req_key": "jimeng_ti2v_v30_pro",
"task_id": "7392616336519610409"
}'响应示例
{
"code": 10000,
"data": {
"video_url": "https://example.com/video.mp4",
"aigc_meta_tagged": true,
"status": "done"
},
"message": "Success",
"request_id": "20250805144938F6E5264E9D24EB0C4E0A",
"time_elapsed": "57.354545ms"
}{
"code": 50413,
"data": null,
"message": "Post Text Risk Not Pass",
"request_id": "202511281418218670D408837A9B0EB58F",
"time_elapsed": "36.799829ms"
}查询响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
video_url | string | 生成的视频 URL（有效期 1 小时） |
aigc_meta_tagged | bool | AIGC 隐式标识是否打标成功 |
status | string | 任务执行状态：in_queue, generating, done, not_found, expired |
错误码
