curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "blackforestlabs/flux-3-max/keyframes-to-video",
"input": {
"keyframes": [
{
"image_url": "https://example.com/seed.png",
"frame_index": 0
},
{
"image_url": "https://example.com/sapling.png",
"frame_index": 60
},
{
"image_url": "https://example.com/blossom.png",
"frame_index": 120
}
],
"prompt": "A seed sprouts, grows into a sapling and blossoms into a cherry tree, time-lapse, fixed camera",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"sound": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Flux
FLUX 3 Max 关键帧生视频
FLUX 3 Max 关键帧生视频 API 通过 frame_index 把 1–10 张图片放到 24 fps 时间轴上，生成它们之间 5–20 秒的连贯运动。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "blackforestlabs/flux-3-max/keyframes-to-video",
"input": {
"keyframes": [
{
"image_url": "https://example.com/seed.png",
"frame_index": 0
},
{
"image_url": "https://example.com/sapling.png",
"frame_index": 60
},
{
"image_url": "https://example.com/blossom.png",
"frame_index": 120
}
],
"prompt": "A seed sprouts, grows into a sapling and blossoms into a cherry tree, time-lapse, fixed camera",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"sound": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- blackforestlabs/flux-3-max/keyframes-to-video — FLUX 3 Max 关键帧生视频，用
frame_index放置 1–10 张图片。
功能
- 关键帧控制：1–10 张图片，每张放在 24 fps 时间轴的某一帧上。
- 时长为 5 到 20 秒的整数，720p 或 1080p。
- 八种宽高比；
auto跟随第一张关键帧图片。 - 默认开启原生音频。
必填参数
keyframes（object[]）：1–10 个对象，每个对象只有两个字段：image_url（string）：关键帧图片的公开 HTTP(S) URL（PNG、JPEG 或 WebP）。frame_index（integer）：该图片在 24 fps 时间轴上的位置，取值0到duration × 24，不能重复。
prompt（string）：关键帧之间的运动与过渡、镜头运动，以及开启sound时的声音。不能为空白。
可选参数
duration（integer）：输出时长，5–20秒。默认5。resolution（string）：720p或1080p。默认720p。aspect_ratio（string）：auto、21:9、2:1、16:9、4:3、1:1、3:4或9:16。默认auto。sound（boolean）：随视频生成原生音频。默认true；设为false输出无声视频。
时长
frame_index 按 24 fps 计帧，因此最大可用序号取决于 duration：
duration | 可用的 frame_index 范围 |
|---|---|
| 5 | 0–120 |
| 10 | 0–240 |
| 15 | 0–360 |
| 20 | 0–480 |
frame_index = t × 24（例如 2.5 秒 → 60）。
输出
任务完成后，查询任务状态和回调内容的files 数组中会返回一个 MP4 视频。
示例
- 5 秒内三个关键帧：种子、树苗和花开分别放在第
0、60、120帧（5 秒视频的开头、中间和结尾）。 - 10 秒 1080p 分镜，带回调：四个镜头放在第
0、96、168、240帧，21:9，无声，并提供callback_url。
注意事项
frame_index超过duration × 24、序号重复或关键帧对象中有多余字段都会返回 400。缩短duration时请确认所有序号仍在范围内。- 上文未列出的字段（如
image_urls）会返回 400。只需首尾帧时，请用 FLUX 3 Max 图生视频。 - 积分在提交时预扣，取决于
resolution和duration。文生视频、图生视频和关键帧生视频的费率相同，sound不影响价格。任务失败会全额退还。当前费率见定价页。 - 本模型没有 4K 档位、不支持
seed，输出最长 20 秒。
授权
所有 API 接口都需要 Bearer Token 认证
获取 API Key：
进入 仪表盘 → API 密钥（API Key 管理页面）获取你的 API Key
在请求头中添加：
Authorization: Bearer VIDGO_API_KEY
请求体
application/json
模型 ID，填 blackforestlabs/flux-3-max/keyframes-to-video。
示例:
"blackforestlabs/flux-3-max/keyframes-to-video"
生成参数。
Show child attributes
Show child attributes
可选的公开 HTTP(S) 地址，任务变为 finished 或 failed 时会收到 POST 请求。建议使用 HTTPS。省略、传 null 或空字符串即不发送回调。
示例:
"https://your-domain.com/callback"