火山官方渠道
使用以下四个公开模型名称调用 Seedance。视频生成与编辑均使用 PopGo 统一的视频 API。
正在核对可用模型…
选择模型
点击模型名称查看分辨率、时长、画幅和参考素材参数。当前可用性及价格见模型与价格。
普通视频生成
按视频任务流程调用 POST /v1/videos。下方每款模型均提供完整参数与示例,将 YOUR_MODEL 替换为所在小节的模型名称。
按需添加 reference_images、reference_videos、reference_audios,填写可公开下载的 HTTPS 素材 URL 数组。首尾帧使用 first_frame、last_frame;具体组合见所选模型参数。
参考图生成
以下示例适用于上面的四款模型。将 YOUR_MODEL 替换为所选模型名称,YOUR_IMAGE_URL 替换为图片直链。
{
"model": "YOUR_MODEL",
"prompt": "The subject in the reference image slowly turns its head; keep the camera steady.",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_images": [
"YOUR_IMAGE_URL"
]
}
图片地址必须是无需登录、直接返回图片内容的 HTTPS 链接,不要使用分享页面。链接在浏览器中能打开,不代表生成服务一定能下载;若提示图片下载失败,请检查链接是否允许外部服务直接访问。
seedance-2-0
通用视频生成
| 字段 | 类型 | 必填 | 取值与限制 | 默认值 |
|---|---|---|---|---|
prompt | string | 是 | minLength=1; 描述需要生成的画面与动作。 | 未声明 |
seconds | string | 否 | ≥ 4; ≤ 15; 输出时长,单位秒;按本行范围或枚举填写。 | 4 |
resolution | string | 否 | 480p, 720p, 1080p, 4k; 输出分辨率;枚举值区分大小写。 | 480p |
aspect_ratio | string | 否 | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9; 输出画幅比例。 | adaptive |
reference_images | array | 否 | maxItems=9 | 未声明 |
reference_videos | array | 否 | maxItems=3 | 未声明 |
reference_audios | array | 否 | maxItems=3 | 未声明 |
first_frame | string | 否 | 首帧图片的 HTTPS 公网直链;遵守本型号的首尾帧组合限制。 | 未声明 |
last_frame | string | 否 | 尾帧图片的 HTTPS 公网直链;遵守本型号的首尾帧组合限制。 | 未声明 |
普通视频生成
{
"model": "YOUR_MODEL",
"prompt": "A calm seaside landscape",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9"
}
seedance-2-0-fast
快速视频生成
| 字段 | 类型 | 必填 | 取值与限制 | 默认值 |
|---|---|---|---|---|
prompt | string | 是 | minLength=1; 描述需要生成的画面与动作。 | 未声明 |
seconds | string | 否 | ≥ 4; ≤ 15; 输出时长,单位秒;按本行范围或枚举填写。 | 4 |
resolution | string | 否 | 480p, 720p; 输出分辨率;枚举值区分大小写。 | 480p |
aspect_ratio | string | 否 | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9; 输出画幅比例。 | adaptive |
reference_images | array | 否 | maxItems=9 | 未声明 |
reference_videos | array | 否 | maxItems=3 | 未声明 |
reference_audios | array | 否 | maxItems=3 | 未声明 |
first_frame | string | 否 | 首帧图片的 HTTPS 公网直链;遵守本型号的首尾帧组合限制。 | 未声明 |
last_frame | string | 否 | 尾帧图片的 HTTPS 公网直链;遵守本型号的首尾帧组合限制。 | 未声明 |
普通视频生成
{
"model": "YOUR_MODEL",
"prompt": "A calm seaside landscape",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9"
}
seedance-2-0-mini
轻量视频生成
| 字段 | 类型 | 必填 | 取值与限制 | 默认值 |
|---|---|---|---|---|
prompt | string | 是 | minLength=1; 描述需要生成的画面与动作。 | 未声明 |
seconds | string | 否 | ≥ 4; ≤ 15; 输出时长,单位秒;按本行范围或枚举填写。 | 4 |
resolution | string | 否 | 480p, 720p; 输出分辨率;枚举值区分大小写。 | 480p |
aspect_ratio | string | 否 | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9; 输出画幅比例。 | adaptive |
reference_images | array | 否 | maxItems=9 | 未声明 |
reference_videos | array | 否 | maxItems=3 | 未声明 |
reference_audios | array | 否 | maxItems=3 | 未声明 |
first_frame | string | 否 | 首帧图片的 HTTPS 公网直链;遵守本型号的首尾帧组合限制。 | 未声明 |
last_frame | string | 否 | 尾帧图片的 HTTPS 公网直链;遵守本型号的首尾帧组合限制。 | 未声明 |
普通视频生成
{
"model": "YOUR_MODEL",
"prompt": "A calm seaside landscape",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9"
}
seedance-2-5
视频生成与视频编辑
| 字段 | 类型 | 必填 | 取值与限制 | 默认值 |
|---|---|---|---|---|
prompt | string | 是 | minLength=1; 描述需要生成的画面与动作。 | 未声明 |
seconds | string | 否 | ≥ 0; ≤ 30; 普通生成填写 4–30 秒;视频编辑填写 "0",同时传入 mode=videoEdit2video。 | 4 |
resolution | string | 否 | 480p, 720p, 1080p; 输出分辨率;枚举值区分大小写。 | 480p |
aspect_ratio | string | 否 | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9; 输出画幅比例。 | adaptive |
reference_images | array | 否 | maxItems=30 | 未声明 |
reference_videos | array | 否 | maxItems=10 | 未声明 |
reference_audios | array | 否 | maxItems=10 | 未声明 |
first_frame | string | 否 | 首帧图片的 HTTPS 公网直链;遵守本型号的首尾帧组合限制。 | 未声明 |
last_frame | string | 否 | 尾帧图片的 HTTPS 公网直链;遵守本型号的首尾帧组合限制。 | 未声明 |
mode | string | 否 | videoEdit2video; seedance-2-5 视频编辑填写 videoEdit2video,同时 seconds="0"、aspect_ratio=adaptive;传入一段 4–30 秒参考视频,可附加最多 30 张图片,不传参考音频。普通生成省略 mode。 | 未声明 |
普通视频生成
{
"model": "YOUR_MODEL",
"prompt": "A calm seaside landscape",
"seconds": "4",
"resolution": "720p",
"aspect_ratio": "16:9"
}
seedance-2-5 视频编辑
视频编辑选择 seedance-2-5,仍调用 POST /v1/videos。将下面的 YOUR_MODEL 替换为该名称,YOUR_VIDEO_URL 替换为可直接下载的 HTTPS 视频地址。
{
"model": "YOUR_MODEL",
"prompt": "Make the scene look like a watercolor painting",
"seconds": "0",
"resolution": "720p",
"aspect_ratio": "adaptive",
"mode": "videoEdit2video",
"reference_videos": [
"YOUR_VIDEO_URL"
]
}
- 传入一段 4–30 秒的参考视频,可附加最多 30 张参考图片;不传参考音频。
seconds填字符串"0",mode填videoEdit2video,aspect_ratio填adaptive。"0"表示按输入视频进行编辑。
查询与获取视频
保存创建响应的 id,使用 GET /v1/videos/{id} 查询;完成后调用 GET /v1/videos/{id}/content 播放或下载。三个请求使用同一个 API Key,完整示例见视频任务流程。