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/image-to-video",
"input": {
"image_urls": [
"https://example.com/portrait.png"
],
"prompt": "She turns toward the window and smiles as the curtains move in the breeze, gentle push-in",
"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 将起始图片（可选结束图片）生成 5–20 秒、720p 或 1080p 的视频，并可输出原生音频。
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/image-to-video",
"input": {
"image_urls": [
"https://example.com/portrait.png"
],
"prompt": "She turns toward the window and smiles as the curtains move in the breeze, gentle push-in",
"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/image-to-video — FLUX 3 Max 图生视频，使用起始帧和可选的结束帧。
功能
- 以一张起始帧图生视频。
- 首尾帧控制：第二张图片决定视频的结束画面。
- 时长为 5 到 20 秒的整数，720p 或 1080p。
- 八种宽高比；
auto跟随第一张图片。 - 默认开启原生音频。
输入模式
- 起始帧：
image_urls传一张图片，视频从该图片开始。 - 起始帧加结束帧：
image_urls传两张图片，第一张为开头，第二张为结尾。
必填参数
image_urls（string[]）：一到两个公开 HTTP(S) 图片 URL（PNG、JPEG 或 WebP）。顺序有意义：起始帧在前，结束帧在后。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输出无声视频。
输出
任务完成后，查询任务状态和回调内容的files 数组中会返回一个 MP4 视频。
示例
- 仅起始帧：一张人像图片配简短的运动提示词，
aspect_ratio: auto让视频保持图片比例。 - 起始帧加结束帧：以关闭和打开的盒子作为两帧，生成 8 秒 1080p 无声视频，并提供
callback_url。
注意事项
image_urls最多两张图片。要在指定时间点放置更多图片，请用 FLUX 3 Max 关键帧生视频。- 图片必须能通过 HTTP(S) 公开访问，且不能内嵌凭证。上文未列出的字段（如
keyframes）会返回 400。 - 积分在提交时预扣，取决于
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/image-to-video。
示例:
"blackforestlabs/flux-3-max/image-to-video"
生成参数。
Show child attributes
Show child attributes
可选的公开 HTTP(S) 地址，任务变为 finished 或 failed 时会收到 POST 请求。建议使用 HTTPS。省略、传 null 或空字符串即不发送回调。
示例:
"https://your-domain.com/callback"