视频生成

创建 AI 视频生成任务，支持文生视频和图生视频。默认同步模式，等待生成完成后直接返回视频 URL。

端点

端点	模式
POST /v1/videos/generations	同步（默认）/ 异步（加 X-Async: true 头）
POST /v1/async/videos/generations	始终异步

请求参数

通用参数

参数	类型	必填	说明
model	string	✅	模型名称，见下方支持列表
prompt	string	条件	视频描述（文生视频必填）
action	string	❌	操作类型：image_to_video（默认） / text_to_video
duration	number	条件	视频时长（秒），百度/Seedance 模型必填
resolution	string	❌	分辨率：360p / 540p / 720p / 1080P
image_url	string	❌	参考图片 URL（图生视频，Seedance/通用格式）

火山引擎 Seedance 特有参数

参数	类型	必填	说明
ratio	string	❌	画面比例：16:9 / 9:16 / 1:1 / 4:3 / 3:4，默认 16:9
generate_audio	boolean	❌	是否生成有声视频，默认 false（仅 2.0 支持）
service_tier	string	❌	服务等级：standard（默认）/ draft（草稿快速预览）
image_role	string	❌	图片角色：first_frame（首帧，默认）/ last_frame（尾帧）/ reference_image（参考图）
last_frame_url	string	❌	尾帧图片 URL（首尾帧控制）
video_url	string	❌	参考视频 URL（2.0 视频编辑）
audio_url	string	❌	参考音频 URL（2.0 有声视频）
images	array	❌	多图参考，格式 [{"url":"...", "role":"reference_image"}]
videos	array	❌	多视频参考，格式 [{"url":"...", "role":"reference_video"}]
watermark	boolean	❌	是否添加水印
return_last_frame	boolean	❌	是否返回尾帧图片

百度视频特有参数

参数	类型	必填	说明
image	object	条件	图生视频的参考图片，格式：{"imageUrl": "https://..."}
audio	string	❌	是否生成音频："true" / "false"
bgm	string	❌	是否生成背景音乐："true" / "false"

腾讯云特有参数

参数	类型	说明
output_config	object	高级输出配置（Duration/Resolution/AspectRatio/AudioGeneration）
file_infos	array	参考图片列表，格式：[{"Type": "Url", "Url": "https://..."}]

请求示例

腾讯云文生视频（GV-3.1）

curl -X POST https://pico.5884.cn/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "GV-3.1",
    "prompt": "一只金毛犬在海边奔跑，慢动作，电影质感",
    "output_config": {
      "Resolution": "1080P",
      "AspectRatio": "16:9",
      "AudioGeneration": "Enabled"
    }
  }'

百度文生视频（K25T）

curl -X POST https://pico.5884.cn/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "K25T",
    "prompt": "一只小猫在草地上奔跑",
    "action": "text_to_video",
    "duration": 5
  }'

百度图生视频（VQ3P）

curl -X POST https://pico.5884.cn/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "VQ3P",
    "prompt": "缓慢移动镜头",
    "action": "image_to_video",
    "duration": 8,
    "image": {"imageUrl": "https://你的图片地址.jpg"},
    "resolution": "540p",
    "audio": "true"
  }'

腾讯云图生视频（Kling-2.1）

curl -X POST https://pico.5884.cn/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Kling-2.1",
    "prompt": "让画面中的人物缓缓转头微笑",
    "file_infos": [
      {"Type": "Url", "Url": "https://example.com/portrait.jpg"}
    ]
  }'

Seedance 文生视频（2.0）

curl -X POST https://pico.5884.cn/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "一只小猫在草地上奔跑，阳光温暖",
    "duration": 8,
    "ratio": "16:9",
    "generate_audio": true
  }'

Seedance 图生视频（首帧）

curl -X POST https://pico.5884.cn/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-pro-250528",
    "prompt": "缓慢推进镜头",
    "image_url": "https://你的图片地址.jpg",
    "duration": 5,
    "ratio": "16:9"
  }'

Seedance 2.0 有声视频

curl -X POST https://pico.5884.cn/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "森林中鸟鸣声起，溪水潺潺",
    "duration": 10,
    "ratio": "16:9",
    "generate_audio": true
  }'

Seedance 2.0 视频参考（风格迁移）

curl -X POST https://pico.5884.cn/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "保持相同动作，转换为水彩画风格",
    "video_url": "https://你的参考视频.mp4",
    "duration": 5,
    "ratio": "16:9"
  }'

Seedance 2.0 首尾帧控制

curl -X POST https://pico.5884.cn/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "人物从站立到坐下",
    "image_url": "https://首帧图片.jpg",
    "last_frame_url": "https://尾帧图片.jpg",
    "duration": 5,
    "ratio": "16:9"
  }'

响应格式

同步模式（默认）

系统自动等待生成完成（最长 10 分钟），直接返回视频 URL：

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://xxx.volces.com/video.mp4"
    }
  ]
}

Seedance 结果格式

火山引擎 Seedance 的原始结果中包含更丰富的信息：

{
  "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/xxx.mp4",
  "duration": 5,
  "ratio": "16:9",
  "usage": { "completion_tokens": 108900, "total_tokens": 108900 }
}

视频 URL 为 TOS 临时链接，有效期约 24 小时，请及时下载保存。

异步模式

添加 X-Async: true 请求头，或使用 /v1/async/videos/generations 端点：

{
  "task_id": "tsk-gcszkgwnzkcqfj1h",
  "status": "pending",
  "model": "K25T",
  "message": "任务已提交，使用 GET /v1/generations/:task_id 轮询结果"
}

使用 任务查询接口 轮询获取结果。

支持的模型

腾讯云

模型	时长	分辨率
GV-3.1 / GV-3.1-fast	8s	720P/1080P
Kling-2.1 / Kling-2.5	5/10s	720P/1080P
Vidu-q2 / Vidu-q2-pro	1~10s	720P/1080P
Hailuo-2.3	6/10s	768P/1080P

百度云

系列	模型
V 系列	V20, VQ1, VQ1C, VQ2, VQ2T, VQ2P, VQ2PF, VQ3P, VQ3T
P 系列	P35, P40, P45, P50, P55
K 系列	K16, K20, K21, K21M, K25T, K26, KO1
H 系列	H20, H23, H23F
VE 系列	VE3.1, VE3.1F, VE3.1P, VE3.1FP

火山引擎 Seedance

模型	时长	特色能力
doubao-seedance-2-0-260128	4~15s	多模态参考/有声视频/联网搜索/视频编辑
doubao-seedance-2-0-fast-260128	4~12s	有声视频/样片模式
doubao-seedance-1-5-pro-251215	2~12s	图生视频/首尾帧
doubao-seedance-1-0-pro-250528	2~12s	文生/图生视频
doubao-seedance-1-0-pro-fast-251015	2~12s	图生视频/首尾帧
doubao-seedance-1-0-lite-i2v-250428	2~12s	图片参考（纯图生视频）
doubao-seedance-1-0-lite-t2v-250428	2~12s	纯文生视频

百度视频注意事项

• 文生视频必须指定 action: "text_to_video" 和 duration
• 图生视频必须提供 image 参数（格式 {"imageUrl": "https://..."}）
• 不同模型支持的 duration 和 resolution 不同，请参考百度官方文档

Seedance 注意事项

• 所有模型都必须指定 duration（时长），建议 5~10 秒
• 模型名称是完整 ID（如 doubao-seedance-2-0-260128），不是缩写
• ratio 支持 16:9、9:16、1:1、4:3、3:4
• generate_audio 有声视频仅 2.0 版本支持
• 视频结果 URL（TOS 临时链接）有效期约 24 小时，请及时下载

提示

使用 GET /v1/models 可查询当前可用的模型列表。