Omni Flash Components API on MaxAPI
Omni Flash Components is served in Google's official Gemini Omni format. POST an interaction to /v1beta/interactions with a MaxAPI bearer key, choose behaviour via generation_config.video_config.task, then poll GET /v1beta/interactions/{id} until it completes. Inline base64 media is hosted automatically.
Common use cases
- Animate one or more reference images into a video
Endpoints
Video generation is asynchronous. POST the request, then poll the task URL until status is succeeded, failed, or canceled.
- POST /v1beta/interactions (official Google Gemini Omni format)
- GET /v1beta/interactions/{id}
Lineage
Source family: Google Gemini video generation. MaxAPI maps the public model ID to its supported Veo or Gemini Omni request mode and returns a pollable task.
Dimensions and sizing
Supports 720p, 1080p, 4k. Supported aspect ratios: 16:9, 9:16, 1:1. Supported reference modes: image_to_video. Allowed duration tiers are 4, 6, 8, 10 seconds.
Available routes
This model runs on a single route: mix. Call it with an API key that permits the mix route (route_mode defaults to mix; sending a different route_mode is rejected).
- mix — blended route that may switch between configured providers for cost, availability, and fallback coverage; billing follows the published entry for this model.
Pricing
Pricing is per route mode. Failed requests are not charged. 1 credit = 1 USD.
- mix: 720p $0.014179 per second
- mix: 1080p $0.01791 per second
- mix: 4k $0.014179 per second
- mix: 720p $0.044776 per-video base fee
- mix: 1080p $0.044776 per-video base fee
- mix: 4k $0.291045 per-video base fee
Quick example
# Official Google Gemini Omni format. Then poll GET /v1beta/interactions/{id}.
curl -X POST "https://api.maxapi.dev/v1beta/interactions" \
-H "Authorization: Bearer $MAXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-omni-flash-preview",
"input": [{"type":"image","uri":"https://your-cdn.com/reference.png"},{"type":"text","text":"animate the reference with a slow push-in"}],
"response_format": { "type": "video", "aspect_ratio": "16:9", "delivery": "uri" },
"generation_config": { "video_config": { "task": "reference_to_video", "duration": 4, "resolution": "720p" } }
}'
FAQ
How do I call Omni Flash Components on MaxAPI?
Use Google's official Gemini Omni format: POST /v1beta/interactions with an Authorization: Bearer header, then poll GET /v1beta/interactions/{id} until status is completed. The OpenAI-style /v1/videos/generations endpoint also works if you prefer it.
How do I switch between route_mode options?
Omni Flash Components runs on a single route: mix. There is nothing to switch — call it with an API key that permits the mix route.
How is billing handled?
Failed requests don't charge credits. Per-image, per-call, and per-generation pricing is billed on completion; token-priced routes settle from upstream usage. 1 credit = 1 USD.
Where does the returned media URL live?
Generated media is normally stored on MaxAPI's CDN for seven days. Pass "asset_delivery": "mirror" on supported generation endpoints to receive URLs on the configured alias domain instead.
Provider source: Google Gemini video generation documentation
Full API reference