即梦视频生成 · 概述#
请求与响应透传即梦官方视频生成接口，参数含义与官方一致。能力简介#
即梦视频生成支持以下任务类型，通过请求体中的 req_key（服务标识）区分：| 任务类型 | 服务标识（req_key） | 说明 |
|---|
| 3.0 Pro 文生视频 + 图生视频（首帧） | jimeng_ti2v_v30_pro | 输出 1080P，支持多镜头叙事 |
| 720P 文生视频 | jimeng_t2v_v30 | 输入提示词生成视频 |
| 720P 图生视频（首帧） | jimeng_i2v_first_v30 | 输入首帧图片和提示词生成视频 |
| 720P 图生视频（首尾帧） | jimeng_i2v_first_tail_v30 | 输入首帧和尾帧图片及提示词，生成从首帧过渡到尾帧的视频 |
| 720P 图生视频（运镜） | jimeng_i2v_recamera_v30 | 通过运镜模板控制镜头运动 |
| 1080P 文生视频 | jimeng_t2v_v30_1080p | 输入提示词生成 1080P 视频 |
| 1080P 图生视频（首帧） | jimeng_i2v_first_v30_1080 | 输入首帧图片和提示词生成 1080P 视频 |
| 1080P 图生视频（首尾帧） | jimeng_i2v_first_tail_v30_1080 | 输入首帧和尾帧图片及提示词，生成 1080P 过渡视频 |
视频生成为异步任务：提交任务后返回 task_id，需通过查询任务接口轮询状态；任务成功后响应中包含视频下载地址（有效期 1 小时），请及时下载或转存。标准调用流程#
提交任务 (POST https://platform.shuyanai.com/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31)
│ 返回 task_id
▼
查询状态 (POST https://platform.shuyanai.com/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31) ← 轮询直至 done
│ 返回 data.video_url
▼
下载视频文件
接口地址#
| 接口 | 方法 | 地址 |
|---|
| 提交任务 | POST | https://platform.shuyanai.com/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31 |
| 查询任务 | POST | https://platform.shuyanai.com/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31 |
路径规则：在平台域名后追加渠道前缀 /jimeng/，再拼接官方原始 Query 参数即可。
例如官方 https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
→ 平台 https://platform.shuyanai.com/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
/jimeng 后的斜杠不能省略。写成 /jimeng?Action=... 会收到 307 跳转，curl 默认不跟随跳转，返回空响应。
Authorization 头携带 Bearer Key 鉴权，无需火山引擎的 HMAC-SHA256 签名：Authorization: Bearer sk-xxx
sk-xxx 替换为您在控制台「模型 API Key」页面（www.shuyanai.com/admin/tokens）创建的 Key。请求头#
| 头部 | 必填 | 说明 |
|---|
Authorization | 是 | Bearer sk-xxx |
Content-Type | 是 | 固定为 application/json |
任务状态值#
| 状态 | 含义 |
|---|
in_queue | 已提交，排队中 |
generating | 处理中 |
done | 处理完成（成功或失败，依据外层 code 判断） |
not_found | 未找到（可 能无此任务或已过期 12 小时） |
expired | 任务已过期，请重新提交 |
响应格式#
{
"code": 10000,
"data": {},
"message": "Success",
"request_id": "string",
"time_elapsed": "string"
}
| 字段 | 类型 | 说明 |
|---|
code | int | 状态码，10000 表示成功 |
message | string | 错误/提示信息 |
request_id | string | 请求 ID，用于跟踪、排查问题 |
data | object | 业务数据 |
time_elapsed | string | 链路耗时 |
相关文档#
