00-概述
即梦视频生成 · 概述
文档版本：v1.0.0 | 最后更新：2026-06-11 本平台已完整适配即梦系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。
能力简介
| 任务类型 | 服务标识 (req_key) | 说明 |
|---|---|---|
| 1080P 文生视频 + 图生视频（首帧） | jimeng_ti2v_v30_pro | 文生视频与图生视频能力，视频生成效果飞跃提升，支持 1080P 高清输出，多镜头叙事，专业级质感。 |
| 720P 文生视频 | jimeng_t2v_v30 | 720P 文生视频，专业级视频生成引擎，准确遵循复杂指令，可驾驭多元艺术风格，生成效果与速度兼备的高性价比之选。 |
| 720P 图生视频（首帧） | jimeng_i2v_first_v30 | 720P 图生视频（首帧），输入首帧图片和提示词生成视频。 |
| 720P 图生视频（首尾帧） | jimeng_i2v_first_tail_v30 | 720P 图生视频（首尾帧），输入首帧和尾帧图片及提示词，生成从首帧过渡到尾帧的视频。 |
| 720P 图生视频（运镜） | jimeng_i2v_recamera_v30 | 720P 图生视频（运镜），通过运镜模板控制相机 移动，输入图片和提示词生成带运镜效果的视频。 |
| 1080P 文生视频 | jimeng_t2v_v30_1080p | 1080P 文生视频，更高分辨率输出，视觉细节更丰富。 |
| 1080P 图生视频（首帧） | jimeng_i2v_first_v30_1080 | 1080P 图生视频（首帧），输入首帧图片和提示词，生成 1080P 高清视频。 |
| 1080P 图生视频（首尾帧） | jimeng_i2v_first_tail_v30_1080 | 1080P 图生视频（首尾帧），输入首帧和尾帧图片及提示词，生成 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
▼
下载视频文件接口地址
路径规则：在平台域名后追加渠道前缀 /jimeng，再拼接官方原始 Query 参数即可。
例如官方https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
→ 平台https://platform.shuyanai.com/jimeng?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
鉴权
Authorization 头携带 Bearer Token 进行鉴权：Authorization: Bearer {API_KEY}{API_KEY} 为您在平台控制台创建的接口密钥。本平台已简化鉴权方式，无需使用火山引擎的 HMAC-SHA256 签名，仅需通过 Bearer Token 即可调用。
请求头
| 头部 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API_KEY} |
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 | 链路耗时 |
相关文档
