VidLabDocs
Copy for agent
llms.txtEvery page and model as links an agent can follow.Agent setup guideThe skill, your key and what to ask for.
StatusSupportGet API key

Gemini Omni 1.2 Flash

Googlegemini-omni-1.2-flash

Google's Gemini Omni 1.2 Flash: text to video, image to video, first and last frames and up to 10 reference images, 360p to 4K, 3 to 15 seconds, with native sound.

POSThttps://vidlab.ai/v1/generations

Send "model": "gemini-omni-1.2-flash" and the fields below. The call answers 202 at once with the generation's id; poll it for the file. Billed per second of output, only when it succeeds.

Request
curl -X POST https://vidlab.ai/v1/generations \
  -H "Authorization: Bearer $VIDLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "gemini-omni-1.2-flash",
  "input": {
    "prompt": "A slow push-in on a perfume bottle on wet black stone",
    "resolution": "360p",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}'
Response
{
  "data": {
    "id": "gen_4Fq9xT2mLr7Kd1sV8bN3pZ0c",
    "object": "generation",
    "status": "queued",
    "model": "gemini-omni-1.2-flash",
    "variant": "360p",
    "units": 5,
    "price_usd": 0.11,
    "outputs": [],
    "created_at": "2026-11-01T18:04:11.000Z",
    "status_url": "/v1/generations/gen_4Fq9xT2mLr7Kd1sV8bN3pZ0c",
    "result_url": "/v1/jobs/gen_4Fq9xT2mLr7Kd1sV8bN3pZ0c/result"
  }
}

Headers

HeaderTypeRequiredValue
AuthorizationstringrequiredBearer vidlab_sk_..., your API key from the dashboard.
Content-Typestringrequiredapplication/json
Idempotency-Keystringoptional8 to 100 letters, digits or _ : . - (a UUID is fine). A retry with the same key never starts or charges twice.

No key yet? Make one under API keys. Keep it on your server, never in a browser or an app.

Body

FieldTypeRequiredDefaultAllowed
modelstringrequiredNone
Must be gemini-omni-1.2-flash
inputobjectrequiredNone
The fields below.
max_cost_usdnumberoptionalNone
Dollars
The most you will pay. Over it, the call answers 422 and nothing is held. Submit a generation
max_wait_snumberoptionalNone
Seconds
The longest you will wait.

Input

The fields of input for text to video. A field the model does not take is refused, never ignored. Files are https links or base64 data URLs; upload a file from your machine first.

FieldTypeRequiredDefaultAllowed
promptstringrequiredNone
Up to 5,000 characters
What to make.
resolutionstringoptional360p
One of: 360p, 720p, 1080p, 4k
Output resolution.
aspect_ratiostringoptional16:9
One of: 16:9, 9:16
Shape of the output.
durationnumberoptional3
3 to 15 seconds
Seconds of output.

Pricing

Billed per second of output. A failed generation is free. The example costs $0.11 (360p, 5 seconds). Check any request for free with POST /v1/generations/quote.

OptionPriceBilled
360p 360p$0.022per second of output
720p 720p$0.049per second of output
1080p 1080p$0.072per second of output
4k 4k$0.145per second of output

Response

202 with the generation (status: "queued"), its price, and where to poll it. The fields are on Generation object.

Get the result

GEThttps://vidlab.ai/v1/generations/{id}

Poll every few seconds until status is succeeded or failed. outputs[].url is the file, on our storage; download it with your key from GET /v1/generations/{id}/content. See Get the result.

curl https://vidlab.ai/v1/generations/gen_4Fq9xT2mLr7Kd1sV8bN3pZ0c?wait=60 \
  -H "Authorization: Bearer $VIDLAB_API_KEY"

Errors

Every error is { "error": { "message", "type", "code" } } and nothing is held. All codes are on Errors.

StatusCodeWhen
400invalid_inputA field this model does not take, a value that is not allowed, or a required field left out. The message names it.
401unauthorizedThe key is missing, unknown or revoked.
422max_cost_exceededNo route can run the call for max_cost_usd or less. Nothing is held.
429api_wallet_exhaustedThe balance has no room for this price. Add credit.
429rate_limitedThis account started 20 generations in the last 10 seconds. Not queued: wait for Retry-After, then send it again.
503api_wallet_reconciliation_requiredThe balance is held for a billing review. Contact support; do not retry until it is cleared.

Other tasks