模型对比
| 模型 | 分辨率支持 | 文生视频 | 图生视频-首帧 | 图生视频-首尾帧 | 运镜功能 |
|---|---|---|---|---|---|
jimeng_v30 | 720p/1080p | ✅ | ✅ | ✅ | ✅ (仅720p) |
jimeng_v30_pro | 1080p | ✅ | ✅ | ❌ | ❌ |
文生视频 (jimeng_v30)
基础的文本生成视频功能。配置说明：
- 将
api.xxx.com替换为您的实际 API 域名 - 将
sk-xxx替换为您的 API 密钥（可在控制台获取）
curl -X POST https://api.xxx.com/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxx" \
-d '{
"model": "jimeng_v30",
"prompt": "一条小河流淌在森林中,鸟儿在树枝上歌唱",
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"seed": -1
}'
{
"task_id": "cgt-20251209112555-fdqtx"
}
参数说明
基础参数（必填）
| 参数名 | 类型 | 说明 | 可选值 |
|---|---|---|---|
model | string | 模型名称 | jimeng_v30 / jimeng_v30_pro |
prompt | string | 文本提示词 | 中英文描述 |
resolution | string | 视频分辨率 | jimeng_v30: 720p/1080pjimeng_v30_pro: 1080p |
ratio | string | 视频宽高比 | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 |
duration | integer | 视频时长（秒） | 5 / 10 |
可选参数
| 参数名 | 类型 | 默认值 | 说明 | 适用场景 |
|---|---|---|---|---|
images | array | - | 图片URL数组 • 单张图片 = 首帧 • 两张图片 = 首尾帧 | 仅 jimeng_v30 支持 |
seed | integer | -1 | 随机种子 • -1 表示随机 • 正整数表示固定种子 | 全部模型 |
template_id | string | - | 运镜模板ID 运镜时必填 | 仅 jimeng_v30 的720p |
camera_strength | string | - | 运镜强度 运镜时必填 | 仅 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://api.xxx.com/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxx" \
-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
}'
{
"task_id": "cgt-20251209112555-fdqtx"
}
图生视频-首尾帧 (jimeng_v30)
基于首尾两帧图片生成视频。curl -X POST https://api.xxx.com/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxx" \
-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
}'
{
"task_id": "cgt-20251209112555-fdqtx"
}
运镜视频 (jimeng_v30)
使用运镜模板生成具有特定镜头运动的视频。运镜功能仅支持
jimeng_v30 模型的 720p 分辨率。curl -X POST https://api.xxx.com/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxx" \
-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
}'
{
"task_id": "cgt-20251209112555-fdqtx"
}
文生视频 (jimeng_v30_pro)
高质量的文本生成视频，仅支持1080p。curl -X POST https://api.xxx.com/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxx" \
-d '{
"model": "jimeng_v30_pro",
"prompt": "一座现代化城市的夜景,灯光闪烁,车流不息",
"resolution": "1080p",
"ratio": "16:9",
"duration": 5,
"seed": -1
}'
{
"task_id": "cgt-20251209112555-fdqtx"
}
图生视频-首帧 (jimeng_v30_pro)
基于首帧图片生成高质量视频。curl -X POST https://api.xxx.com/v1/video/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxx" \
-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
}'
{
"task_id": "cgt-20251209112555-fdqtx"
}
查询视频任务
使用任务ID查询视频生成结果。curl https://api.xxx.com/v1/video/generations/{task_id} \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxx"
{
"code": "success",
"message": "",
"data": {
"task_id": "cgt-20251209173715-6mn48",
"action": "generate",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1765273035,
"start_time": 1765273037,
"finish_time": 1765273082,
"progress": "100%",
"data": {
"id": "cgt-20251209173715-6mn48",
"seed": 11,
"model": "doubao-seedance-1-0-pro-fast-251015",
"ratio": "16:9",
"usage": {
"total_tokens": 97605,
"completion_tokens": 97605
},
"status": "succeeded",
"content": {
"video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/..."
},
"duration": 10,
"created_at": 1765273035,
"resolution": "480p",
"updated_at": 1765273077,
"service_tier": "default",
"framespersecond": 24,
"execution_expires_after": 172800
}
}
}
任务状态说明
| 状态 | 说明 |
|---|---|
PENDING | 任务排队中 |
PROCESSING | 任务处理中 |
SUCCESS | 任务成功完成 |
FAILED | 任务失败 |
视频生成任务的执行时间取决于队列长度和视频时长，通常需要几分钟时间。