> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # Gemini Omni Flash R2V > [Core Function] Gemini Omni Flash R2V (Reference-to-Video) generates a short 720p video guided by up to three reference images via the Interactions API. [Strengths] It fuses the styles, subjects, or elements from multiple reference images (referred to in the text prompt) into a single coherent animated clip with synchronized audio. [Best For] Highly recommended for: blending characters or visual styles from several images, reference-guided creative shots, and multi-subject compositions where the prompt directs how the references combine. [Limitations] Do NOT use this model if you only have a single starting frame (use I2V instead), or if you need 1080p or 4K or clips longer than 10 seconds; it accepts 1 to 3 reference images and outputs 720p up to 10 seconds (16:9 or 9:16). [Routing] Choose this when the user supplies multiple reference images to combine into one video. For single first-frame animation use Gemini Omni Flash I2V; to modify an existing video use Gemini Omni Flash Video Edit. ## OpenAPI ````yaml /model-api/google/google-i2v.json post /google/gemini-omni-flash-r2v openapi: 3.1.0 info: description: The image-to-video models API from Google (Veo series). version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: Google Image-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The image-to-video models API from Google. security: - bearerAuth: [] paths: /google/gemini-omni-flash-r2v: post: summary: Gemini Omni Flash R2V description: >- [Core Function] Gemini Omni Flash R2V (Reference-to-Video) generates a short 720p video guided by up to three reference images via the Interactions API. [Strengths] It fuses the styles, subjects, or elements from multiple reference images (referred to in the text prompt) into a single coherent animated clip with synchronized audio. [Best For] Highly recommended for: blending characters or visual styles from several images, reference-guided creative shots, and multi-subject compositions where the prompt directs how the references combine. [Limitations] Do NOT use this model if you only have a single starting frame (use I2V instead), or if you need 1080p or 4K or clips longer than 10 seconds; it accepts 1 to 3 reference images and outputs 720p up to 10 seconds (16:9 or 9:16). [Routing] Choose this when the user supplies multiple reference images to combine into one video. For single first-frame animation use Gemini Omni Flash I2V; to modify an existing video use Gemini Omni Flash Video Edit. operationId: geminiOmniFlashR2VAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GeminiOmniFlashR2VRequest' examples: basic: summary: Fuse reference images value: prompt: >- Combine the character and the background style into one scene referenceImages: - https://example.com/ref-1.jpg - https://example.com/ref-2.jpg responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' example: code: 0 message: success data: status: pending task_id: task-omni001 model_id: google/gemini-omni-flash-r2v get_result: method: GET url: https://api.modellix.ai/api/v1/tasks/task-omni001 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: GeminiOmniFlashR2VRequest: type: object required: - prompt - referenceImages description: >- Gemini Omni Flash reference-to-video request. Fuses 1 to 3 `referenceImages` guided by the `prompt`. Supports `aspectRatio` and `duration` (up to 10 seconds). Output is fixed at 720p. properties: prompt: type: string description: Video description text minLength: 1 example: Combine the character and the background style into one scene referenceImages: type: array description: >- 1 to 3 reference image URLs whose subjects or styles are fused into the video, guided by the prompt. minItems: 1 maxItems: 3 items: type: string example: https://example.com/ref-1.jpg example: - https://example.com/ref-1.jpg - https://example.com/ref-2.jpg aspectRatio: type: string description: Video aspect ratio. Output resolution is fixed at 720p. default: '16:9' enum: - '16:9' - '9:16' example: '16:9' duration: type: string description: Video duration in seconds (string type). Maximum 10 seconds. enum: - '4' - '6' - '8' - '10' default: '8' example: '8' AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier for polling example: task-abc123 model_id: type: string description: Model ID in `provider/model` format example: google/veo-3.1-i2v get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. ErrorResponse: type: object required: - code - message properties: code: type: integer description: Error code (equals HTTP status code) example: 400 message: type: string description: 'Error message in format ''Category: detail''' example: 'Invalid parameters: parameter ''prompt'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 message: 'Invalid parameters: parameter ''prompt'' is required' Unauthorized: description: Unauthorized - Invalid or missing API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 message: 'Authentication failed: invalid API key' TooManyRequests: description: Too many requests - Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum requests per minute schema: type: integer example: 100 X-RateLimit-Remaining: description: Remaining quota in current window schema: type: integer example: 0 X-RateLimit-Reset: description: Rate limit window reset time (Unix timestamp) schema: type: integer example: 1704067260 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 429 message: >- Rate limit exceeded: 100 requests per minute, retry after 60 seconds InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 500 message: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````