curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "google/gemini-omni-flash/reference-to-video",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "resolution": "720p",
    "duration": 6,
    "aspect_ratio": "16:9",
    "image_urls": [
      "https://example.com/image.png",
      "https://example.com/image.png",
      "https://example.com/image.png"
    ]
  }
}
'

{
  "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>"
}

​

Omni Flash Reference to Video

Use visual references to guide new scenes with Gemini Omni Flash, combining image input and text direction in video output up to 4K.

​

Available Models

• google/gemini-omni-flash/reference-to-video - Generate a new video guided by reference material and a prompt.

​

Duration Options

• 4, 6, 8, 10 seconds - Set duration to one of these values. Default: 6 seconds.

​

Key Features

• Combine exactly three reference images with a prompt to guide the video.
• Choose from 720p, 1080p, 4k output resolutions.
• Supports landscape (16:9) and portrait (9:16) framing.

​

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. Maximum length: 20,000 characters.

​

Image URLs

• image_urls: Required. Provide exactly 3 image URLs.
• Use image_urls for this workflow, not reference_image_urls.
• Images must be publicly accessible and directly downloadable.

​

Resolution

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

​

Aspect Ratio

• aspect_ratio: 16:9, 9:16. Default: 16:9.

​

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.