Skip to main content

​
模型对比

模型分辨率支持文生视频图生视频-首帧图生视频-首尾帧运镜功能
jimeng_v30720p/1080p✅✅✅✅ (仅720p)
jimeng_v30_pro1080p✅✅❌❌

​
参数说明

​
基础参数（必填）

参数名类型说明可选值
modelstring模型名称jimeng_v30 / jimeng_v30_pro
promptstring文本提示词中英文描述
resolutionstring视频分辨率jimeng_v30: 720p/1080p
jimeng_v30_pro: 1080p
ratiostring视频宽高比16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9
durationinteger视频时长（秒）5 / 10

​
可选参数

参数名类型默认值说明适用场景
imagesarray-图片URL数组
• 单张图片 = 首帧
• 两张图片 = 首尾帧		仅 jimeng_v30 支持
seedinteger-1随机种子
• -1 表示随机
• 正整数表示固定种子		全部模型
template_idstring-运镜模板ID
运镜时必填		仅 jimeng_v30 的720p
camera_strengthstring-运镜强度
运镜时必填		仅 jimeng_v30 的720p

​
运镜模板

​
模板列表

希区柯克推进

hitchcock_dolly_in - 镜头向前推进

希区柯克拉远

hitchcock_dolly_out - 镜头向后拉远

机械臂

robo_arm - 机械臂运镜效果

动感环绕

dynamic_orbit - 动态环绕拍摄

中心环绕

central_orbit - 围绕中心旋转

起重机

crane_push - 起重机运镜

超级拉远

quick_pull_back - 快速拉远镜头

逆时针回旋

counterclockwise_swivel - 逆时针旋转

顺时针回旋

clockwise_swivel - 顺时针旋转

手持运镜

handheld - 手持摄影效果

快速推拉

rapid_push_pull - 快速推拉镜头

​
运镜强度

值说明
weak弱 - 运镜幅度较小，画面变化柔和
medium中 - 运镜幅度适中，平衡效果
strong强 - 运镜幅度较大，视觉冲击力强

​
文生视频 (jimeng_v30)

基础的文本生成视频功能。 
curl -X POST https://{YOUR_API_ENDPOINT}/v1/video/generations \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer {YOUR_API_KEY}" \
   -d '{
    "model": "jimeng_v30",
    "prompt": "一条小河流淌在森林中,鸟儿在树枝上歌唱",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": -1
}'

​
图生视频-首帧 (jimeng_v30)

基于首帧图片生成视频。 
curl -X POST https://{YOUR_API_ENDPOINT}/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -d '{
    "model": "jimeng_v30",
    "prompt": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头",
    "images": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": -1
  }'

​
图生视频-首尾帧 (jimeng_v30)

基于首尾两帧图片生成视频。 
curl -X POST https://{YOUR_API_ENDPOINT}/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -d '{
    "model": "jimeng_v30",
    "prompt": "360度环绕运镜",
    "images": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": -1
  }'

​
运镜视频 (jimeng_v30)

使用运镜模板生成具有特定镜头运动的视频。
运镜功能仅支持 jimeng_v30 模型的 720p 分辨率。
curl -X POST https://{YOUR_API_ENDPOINT}/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -d '{
    "model": "jimeng_v30",
    "prompt": "一辆跑车停在赛道上,阳光照在车身上",
    "images": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "template_id": "dynamic_orbit",
    "camera_strength": "strong",
    "seed": -1
  }'

​
文生视频 (jimeng_v30_pro)

高质量的文本生成视频，仅支持1080p。 
curl -X POST https://{YOUR_API_ENDPOINT}/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -d '{
    "model": "jimeng_v30_pro",
    "prompt": "一座现代化城市的夜景,灯光闪烁,车流不息",
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5,
    "seed": -1
  }'

​
图生视频-首帧 (jimeng_v30_pro)

基于首帧图片生成高质量视频。 
curl -X POST https://{YOUR_API_ENDPOINT}/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -d '{
    "model": "jimeng_v30_pro",
    "prompt": "女孩缓缓睦开眼睛,头发随风飘动",
    "images": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5,
    "seed": -1
  }'

​
查询视频任务

使用任务ID查询视频生成结果。 
curl https://{YOUR_API_ENDPOINT}/v1/video/generations/{task_id} \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer {YOUR_API_KEY}"

​
任务状态说明

状态说明
PENDING任务排队中
PROCESSING任务处理中
SUCCESS任务成功完成
FAILED任务失败
视频生成任务的执行时间取决于队列长度和视频时长，通常需要几分钟时间。