How to Use Gemini Omni Video via API

Gemini Omni Flash is Google's affordable video model, available on Hypereal through a simple REST API. It generates 720P video clips from a text prompt, or from a prompt plus 1-3 image references — no subscription needed, and no special client library required.

Key specs:

• Resolution: 720P
• Durations: 6 seconds or 10 seconds
• Aspect ratios: 16:9 (landscape) or 9:16 (portrait)
• Image input: optional image_urls array with 1-3 uploaded or public image URLs
• No audio — video only
• Price: $0.1725 per clip (flat, pay-as-you-go)

New accounts receive free credits, so you can test the endpoint before spending anything.

Step 1: Create a free Hypereal account and API key

Sign up at hypereal.cloud, open the dashboard, and go to Manage API Keys to create your key.

Store it as an environment variable:

export HYPEREAL_API_KEY="ck_..."

Step 2: Generate your first video

Send a POST request to the video generation endpoint with your prompt and parameters:

curl -X POST https://hypereal.cloud/api/v1/videos/generate \
  -H "Authorization: Bearer $HYPEREAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini_omni_flash",
    "prompt": "a white cube rotating on a black background, clean product demo",
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "720P",
    "image_urls": [
      "https://your-cdn.com/product-reference.png"
    ]
  }'

The API returns a job ID and a poll URL:

{
  "jobId": "job_abc123",
  "pollUrl": "https://hypereal.cloud/api/v1/jobs/job_abc123"
}

Video generation is asynchronous. Save the pollUrl and use it in the next step to retrieve the result.

Step 3: Parameters — duration, resolution, and aspect ratio

Parameter	Allowed values	Notes
model	gemini_omni_flash	Required
prompt	any string	Describe what happens in the video
duration	6 or 10	Seconds; defaults to 6
resolution	720P	Only supported resolution
aspect_ratio	16:9 or 9:16	Landscape or portrait
image_urls	1-3 image URLs	Optional uploaded or public image URLs for image-guided video

Use 16:9 for product demos, scenes, and landscape shots. Use 9:16 for mobile-first or social vertical clips.

For local images, upload the file first and pass the returned URL in image_urls. Direct base64 image payloads are not supported for Gemini Omni Flash video.

Step 4: Poll for the result

The generation typically completes within 30–90 seconds. Poll the job URL until status is "completed":

curl https://hypereal.cloud/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer $HYPEREAL_API_KEY"

Response when done:

{
  "jobId": "job_abc123",
  "status": "completed",
  "output": {
    "url": "https://cdn.hypereal.cloud/videos/job_abc123.mp4"
  }
}

The url field contains a direct link to the generated MP4 file. Download it or embed it directly.

A simple polling loop in Node.js:

const delay = ms => new Promise(r => setTimeout(r, ms));

async function waitForVideo(jobId, apiKey) {
  const pollUrl = `https://hypereal.cloud/api/v1/jobs/${jobId}`;
  while (true) {
    const res = await fetch(pollUrl, {
      headers: { Authorization: `Bearer ${apiKey}` },
    });
    const data = await res.json();
    if (data.status === 'completed') return data.output.url;
    if (data.status === 'failed') throw new Error('Generation failed');
    await delay(5000);
  }
}

Pricing

Model	Price per clip	Duration options	Resolution
gemini_omni_flash	$0.1725	6 s or 10 s	720P

Billing is pay-as-you-go — you are charged per clip, not per second. A 10-second clip costs the same as a 6-second clip. There is no monthly subscription required to use this model.

Free trial credits are enough to generate your first few clips. Top up general credits from the dashboard when you need more volume.

When to use Gemini Omni Flash

Gemini Omni Flash is a good fit when you need:

• Short product or concept demos — 6-second clips work well for landing pages and ads
• Image-guided motion — attach product, character, or style references with image_urls
• Prototyping — at $0.17/clip it is affordable to iterate on a prompt without committing to a premium model
• Vertical social content — the 9:16 mode is ready for Reels and Shorts without any cropping
• Batch pipelines — the flat-rate pricing makes cost estimation straightforward for automated workflows

For longer clips or scenes requiring audio, look at the Veo 3.1 endpoints on Hypereal. For Gemini Omni Flash, the sweet spot is fast, affordable 720P clips at volume.