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/image-to-video",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "sound": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

​

FLUX 3 Image to Video

Bring a still image into motion with FLUX 3, using text to direct the scene with optional sound and output up to 1080p.

​

Available Models

• blackforestlabs/flux-3/image-to-video - Generate video from image input.

​

Duration Options

• 5-20 seconds - Set duration as an integer. Default: 5 seconds.

​

Key Features

• Animate a single reference image.
• Choose from 720p, 1080p output resolutions.
• Control audio generation with sound; it defaults to true.

​

Advanced Parameters

Set model and optional callback_url at the request root. Place the parameters below inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.

​

Prompt

• prompt: Required. Describe the scene and desired motion.
• The prompt must not be blank when supplied.

​

Image URLs

• image_urls: Required. Provide exactly 1 image URL.
• Images must be publicly accessible and directly downloadable.

​

Resolution

• resolution: 720p, 1080p. Default: 720p.

​

Aspect Ratio

• aspect_ratio: auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16. Default: auto.

​

Audio

• sound: Set to true to enable generated audio, or false to disable it. Default: true.

​

Pricing

Pricing depends on the selected model and applicable output settings. Check the Vidgo dashboard for the current rate. Credits are deducted on submission and refunded if the task fails.