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/text-to-video",
"input": {
"prompt": "A paper boat drifts down a rain-soaked city gutter at dusk, neon reflections rippling, slow tracking shot, soft rain and distant traffic",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"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/text-to-video",
"input": {
"prompt": "A paper boat drifts down a rain-soaked city gutter at dusk, neon reflections rippling, slow tracking shot, soft rain and distant traffic",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"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/text-to-video — FLUX 3 Max 文生视频，5–20 秒，720p 或 1080p，可选音频。
功能
- 只需一段提示词即可文生视频，无需图片。
- 时长为 5 到 20 秒的整数。
- 输出 720p 或 1080p。
- 八种宽高比，包括电影感的
21:9、2:1，竖屏9:16和方形1:1。 - 默认开启原生音频，可在提示词中描述环境声、音效或对白。
必填参数
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 视频。
示例
- 5 秒 720p 带音频短片：简短提示词中同时写明声音（雨声、车流声），
16:9，sound: true。 - 15 秒竖屏 1080p 无声短片：面向信息流的
9:16，sound: false，并提供callback_url接收完成通知。
注意事项
- 本 ID 只接受文本。要让起始图片动起来，请用 FLUX 3 Max 图生视频；要把图片固定在指定帧上，请用 FLUX 3 Max 关键帧生视频。
- 上文未列出的字段（如
image_urls、keyframes）会返回 400。model和callback_url放在请求根级，不要放进input。 - 积分在提交时预扣，取决于
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/text-to-video。
示例:
"blackforestlabs/flux-3-max/text-to-video"
生成参数。
Show child attributes
Show child attributes
可选的公开 HTTP(S) 地址，任务变为 finished 或 failed 时会收到 POST 请求。建议使用 HTTPS。省略、传 null 或空字符串即不发送回调。
示例:
"https://your-domain.com/callback"