gemini-omni-1-1

Quick example

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-omni-1-1",
    "prompt": "A ginger cat hops onto a sunlit kitchen counter, slow dolly-in",
    "duration": 6,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

import requests

resp = requests.post(
    "https://reapi.ai/api/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "gemini-omni-1-1",
        "prompt": "A ginger cat hops onto a sunlit kitchen counter, slow dolly-in",
        "duration": 6,
        "resolution": "1080p",
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
print(resp.json())

const r = await fetch("https://reapi.ai/api/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gemini-omni-1-1",
    prompt: "A ginger cat hops onto a sunlit kitchen counter, slow dolly-in",
    duration: 6,
    resolution: "1080p",
    aspect_ratio: "16:9",
  }),
});
console.log(await r.json());

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    body, _ := json.Marshal(map[string]any{
        "model":        "gemini-omni-1-1",
        "prompt":       "A ginger cat hops onto a sunlit kitchen counter, slow dolly-in",
        "duration":     6,
        "resolution":   "1080p",
        "aspect_ratio": "16:9",
    })
    req, _ := http.NewRequest("POST",
        "https://reapi.ai/api/v1/videos/generations", bytes.NewReader(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    out, _ := io.ReadAll(resp.Body)
    fmt.Println(string(out))
}

Submit response

{
  "id": "task_01a04cbf7c25765daf9e00404ce84dc6",
  "model": "gemini-omni-1-1",
  "status": "processing",
  "created_at": 1787994015
}

Poll GET /api/v1/tasks/{id} (see the Tasks reference) until status === "completed". The completed payload's output.video_urls holds the generated MP4 URL, valid for 7 days.

Authentication

Every call needs a Bearer token. Generate keys at reapi.ai/settings/apikeys.

Authorization: Bearer YOUR_API_KEY

Keys carry the active workspace's billing scope — there is no separate project header.

Endpoint

POST /api/v1/videos/generations
GET  /api/v1/tasks/{id}

Submission is async. The POST returns immediately with a task_id; the task endpoint returns the same envelope until completion. Polling does not consume credits.

What changed from gemini-omni

Same endpoint, same request shape, same task polling. Switching is a one-line change in the model field. The differences:

Google's announcement also lists scene extension and first-plus-last-frame interpolation; neither is exposed on this endpoint yet.

Mode routing

gemini-omni-1-1 picks its mode from the counts of image_urls and video_urls you send — there is no mode parameter. generation_type then decides what the images mean:

Request body

model — required

string. Must be "gemini-omni-1-1".

prompt — string, required

Up to 2,000 characters. Required in every mode. Empty / whitespace-only prompts are treated as missing.

duration — integer, default 6

One of 4, 6, 8, 10 seconds. Other values are rejected with 400 duration must be one of 4, 6, 8, 10.

resolution — string, default "720p"

360p / 720p / 1080p / 4k. Lowercase is canonical; uppercase forms ("4K") are accepted and normalized. Drives the per-generation rate — 360p, 720p and 1080p share the same price; only 4K is uplifted.

aspect_ratio — string, default "16:9"

Output framing. One of:

Unknown ratios are rejected with 400 invalid aspect_ratio.

size — string, alias for aspect_ratio

Accepted for parity with gemini-omni. If both are sent, they must match; otherwise 400 aspect_ratio and size disagree. The reapi playground does not surface size; the JSON body still accepts it.

generation_type — string, optional

How image_urls are used. Omit to keep the upstream default.

frame cannot be combined with video_urls. Other values are rejected with 400 invalid generation_type.

image_urls — string[]

Array of public HTTP(S) URLs. Allowed counts: 0, 1, or 3.

• 0 entries — text-to-video.
• 1 entry — image-to-video (frame) or single reference (reference).
• 3 entries — three-image fusion (reference).

video_urls — string[]

Array of public HTTP(S) URLs. Allowed counts: 0 or 1.

• 0 entries — non-reference modes (text / image / fusion).
• 1 entry — reference-to-video. The source clip drives the output; it must be ≤ 30 seconds (longer is rejected with 400). Billed at a flat per-generation rate (not per second). duration MUST be omitted in this mode; generation_type = "frame" is not allowed.

content_filter — boolean, optional

Pre-submit moderation of the prompt and input images. Omit to keep the upstream default. When true, a request that trips the filter is refused before any generation runs and nothing is charged.

Response envelope

Submit and poll share the same shape — only status and output fill in over time.

{
  "id": "task_01a04cbf7c25765daf9e00404ce84dc6",
  "model": "gemini-omni-1-1",
  "status": "completed",
  "created_at": 1787994015,
  "output": {
    "video_urls": ["https://cdn.reapi.ai/media/tasks/task_01a04cbf7c25765daf9e00404ce84dc6/0.mp4"]
  },
  "error": null
}

output.video_urls URLs are valid for 7 days. Re-host to your own storage if you need them longer.

Validation errors

All cases below return HTTP 400 with code 20003 unless noted. Pattern-match on code, not message — message strings carry request-specific context and are not a stable contract.

The full envelope is { "error": { "code", "message", "request_id" } } — see Errors catalog for the wire format and request_id correlation tips.

Recipes

360p draft, then the 4K keeper

Send the draft first:

{
  "model": "gemini-omni-1-1",
  "prompt": "Macro shot of a butterfly landing on a pale pink blossom, golden backlight",
  "duration": 6,
  "resolution": "360p",
  "aspect_ratio": "16:9"
}

When the take works, change one field:

{
  "model": "gemini-omni-1-1",
  "prompt": "Macro shot of a butterfly landing on a pale pink blossom, golden backlight",
  "duration": 6,
  "resolution": "4k",
  "aspect_ratio": "16:9"
}

Image-to-video — lock the first frame

{
  "model": "gemini-omni-1-1",
  "prompt": "A ginger cat hops onto the counter and sniffs the plate, slow dolly-in",
  "generation_type": "frame",
  "image_urls": ["https://your-cdn.com/first_frame.jpg"],
  "duration": 6,
  "resolution": "1080p"
}

Single reference image — guide the subject, free the framing

{
  "model": "gemini-omni-1-1",
  "prompt": "The same character walking through a rainy neon street, tracking shot",
  "generation_type": "reference",
  "image_urls": ["https://your-cdn.com/character.jpg"],
  "duration": 8,
  "resolution": "1080p"
}

Three-image fusion

{
  "model": "gemini-omni-1-1",
  "prompt": "A man rides a wooden bicycle through the village market, handheld tracking shot",
  "generation_type": "reference",
  "image_urls": [
    "https://your-cdn.com/village.jpg",
    "https://your-cdn.com/character.jpg",
    "https://your-cdn.com/bicycle.jpg"
  ],
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

Reference-to-video — match a source clip

{
  "model": "gemini-omni-1-1",
  "prompt": "the same scene but at night with neon lights",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "video_urls": ["https://your-cdn.com/source.mp4"]
}

The output tracks the source clip (which must be ≤ 30s); omit duration and do not set generation_type = "frame". Billing is a flat per-generation rate (see Pricing below).

With the content filter on

{
  "model": "gemini-omni-1-1",
  "prompt": "A product spot for a ceramic mug on a wooden table, soft daylight",
  "content_filter": true,
  "duration": 4,
  "resolution": "720p"
}

Choosing a mode

Polling pattern

The task endpoint behaves identically to other video tasks — the only difference is the completed output shape (video_urls instead of image_urls). A pragmatic schedule:

0–5 minutes:    poll every 5s
5 min – 1 h:    back off gradually toward 1 min
≥ 1 h:          cap at 3 min between polls

A typical task completes in about two minutes. The worker's wall-clock cap is 48 hours, comfortably above any realistic queue.

Pricing

Two billing modes — picked by request shape.

Per generation — text / image / fusion

Charged once per submitted job. 360p, 720p and 1080p share the same rate at every duration; only 4K is uplifted. Duration tiers are 4s / 6s / 8s / 10s. See current per-tier rates on the Gemini Omni 1.1 model page.

Flat per generation — reference-to-video

Triggered when video_urls is set. Charged once per job at a flat rate by resolution — independent of clip length. 360p, 720p and 1080p share the same rate; 4K is uplifted. The source clip must be ≤ 30 seconds: the gateway probes its decoded length server-side and rejects longer clips with 400. See current rates on the Gemini Omni 1.1 model page.

Bill formula

1 credit = $0.001. Integer credits = ceil(usd × 1000). Failed jobs refund automatically.

Tips

• Draft at 360p, ship at 1080p or 4K. Same price as 720p, faster to render; the request body does not change between draft and final.
• Say what the image is for. frame when the still must be frame 1 (product shots, storyboards); reference when you want the subject but a new framing.
• Prompt motion, not just scene. "Slow push-in, warm tones, shallow depth of field" outperforms a pure noun-list of what's on screen.
• Three-image fusion needs cohesive references. Pick three images that share lighting and composition cues.
• Keep reference clips ≤ 30s and omit duration — the server rejects requests that pass both.

Related

• Gemini Omni (1.0)
• Errors catalog
• Authentication
• Quickstart