Documentation
Video generation
Text-to-video, image-to-video, and reference-based video models.
Create video from text, a starting image, reference clips, or multi-shot setups. Most models return PENDING first — poll Jobs with the returned id.
URL: POST https://api.thefluxtrain.com/api/v1/video-generate/generate
Authentication: x-api-key
Request body
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | No | veo-3.1-fast | Video model ID (full list in OpenAPI) |
prompt | string | No | — | Text prompt |
image | string | No | — | Start frame URL |
last_frame | string | No | — | End frame URL |
reference_images | string | No | — | Reference image URLs |
reference_videos | string | No | — | Reference videos (Seedance 2.0, max 3) |
reference_audios | string | No | — | Reference audio URLs |
video | string | No | — | Reference video URL |
duration | integer | No | 5 | Duration in seconds (1–60) |
resolution | string | No | — | e.g. 720p, 1080p |
aspect_ratio | string | No | 16:9 | Aspect ratio |
generate_audio | boolean | No | true | Generate or keep audio |
camera_fixed | boolean | No | — | Seedance: fix camera |
elements | object | No | — | Kling V3 character/object elements |
multi_prompts | object | No | — | Kling multi-shot { prompt, duration } |
shot_type | string | No | customize | Kling shot type |
folder_id | string | No | — | Folder UUID in your account |
message_id | string | No | — | Your own tracking ID |
Common models: veo-3.1-fast, veo-3.1, kling-o3-image-to-video-pro, seedance-2.0-image-to-video, happy-horse-text-to-video, gemini-omni-flash-text-to-video, gemini-omni-flash-image-to-video, gemini-omni-flash-reference-to-video, gemini-omni-flash-video-edit, and others — see OpenAPI for the full list.
Example (image-to-video)
{
"model": "veo-3.1-fast",
"prompt": "Slow pan across the scene, cinematic",
"image": "https://example.com/frame.jpg",
"duration": 5,
"aspect_ratio": "16:9",
"folder_id": "your-folder-uuid"
}
Response
| Field | Type | Description |
|---|---|---|
id | string | Job ID — poll via Jobs |
url | string | Video URL when status is SUCCESS |
status | string | Often PENDING at first |
media_type | string | VIDEO |
meta | object | Provider metadata |
folder_id | string | null | Folder UUID |
provider | string | null | Provider name |
provider_id | string | null | Provider job ID |
Example
{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"url": "",
"status": "PENDING",
"media_type": "VIDEO",
"meta": {},
"provider_id": "provider-job-id"
},
"error": null
}