> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Omni Flash Video Edit

> Rework existing video with Gemini Omni Flash, using written instructions to guide changes to the scene with output up to 4K.

<Tip>
  1. Submit the request with `VIDGO_API_KEY`. A `task_id` is returned immediately. Keep it until the task reaches `finished` or `failed`.
  2. Use [Query Task Status](/api-manual/task-management/status) to retrieve the result. If you provide a `callback_url`, Vidgo sends the result to your [webhook](/api-manual/task-management/webhooks) when the task finishes or fails.
</Tip>

# Omni Flash Video Edit

Rework existing video with Gemini Omni Flash, using written instructions to guide changes to the scene with output up to 4K.

## Available Models

* **google/gemini-omni-flash/video-edit** - Edit an existing video using written instructions.

## Duration Options

* Provide one source video in `video_urls`. This workflow does not impose a source-video duration limit.
* Do not send `duration` for video editing.

## Key Features

* Edit an existing video using written instructions.
* Choose from `720p`, `1080p`, `4k` output resolutions.
* Supports landscape (`16:9`) and portrait (`9:16`) framing.

## Advanced Parameters

Set `model` and optional `callback_url` at the request root. Place the parameters below inside `input`.

Send only the input fields supported by this workflow. Unsupported `input` fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.

### Prompt

* `prompt`: Required. Describe the requested changes to the video.
* The prompt must not be blank when supplied. Maximum length: **20,000 characters**.

### Source Video

* `video_urls`: Required. Provide an array containing exactly one publicly accessible source video URL.

### Resolution

* `resolution`: `720p`, `1080p`, `4k`. Default: `720p`.

### Aspect Ratio

* `aspect_ratio`: `16:9`, `9:16`. Default: `16:9`.

## Pricing

Pricing depends on the selected model and applicable output settings. Check the Vidgo dashboard for the current rate.

Credits are deducted on submission and refunded if the task fails.


## OpenAPI

````yaml api-manual/video-series/google-gemini-omni-flash-video-edit.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - Omni Flash Video Edit
  description: >-
    Rework existing video with Gemini Omni Flash, using written instructions to
    guide changes to the scene with output up to 4K.
  version: 1.0.0
servers:
  - url: https://api.vidgo.ai
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Video Series
      summary: Omni Flash Video Edit
      description: >-
        Send only the fields shown for this workflow. Parameters from other
        workflows are rejected before credits are deducted.


        When supplied, prompt and text must not be blank. Input URL fields
        require HTTP(S) URLs with a hostname and no embedded credentials.


        Video editing requires exactly one video URL in video_urls; missing or
        empty arrays are rejected. Omit duration. No source-video duration limit
        is imposed by this workflow.
      operationId: submit_google_gemini_omni_flash_video_edit
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - input
              additionalProperties: true
              properties:
                model:
                  type: string
                  enum:
                    - google/gemini-omni-flash/video-edit
                  example: google/gemini-omni-flash/video-edit
                  description: >-
                    Vidgo public model ID. Must be
                    `google/gemini-omni-flash/video-edit`.
                input:
                  type: object
                  required:
                    - prompt
                    - video_urls
                  properties:
                    prompt:
                      type: string
                      maxLength: 20000
                      minLength: 1
                      description: Prompt.
                    video_urls:
                      type: array
                      minItems: 1
                      maxItems: 1
                      items:
                        type: string
                        format: uri
                        description: Video urls.
                      description: >-
                        Required: exactly one publicly accessible HTTP(S) source
                        video URL. Missing or empty arrays are rejected. Omit
                        duration; no source-video duration limit is imposed by
                        this workflow.
                    resolution:
                      type: string
                      enum:
                        - 720p
                        - 1080p
                        - 4k
                      default: 720p
                      description: Resolution.
                    aspect_ratio:
                      type: string
                      enum:
                        - '16:9'
                        - '9:16'
                      default: '16:9'
                      description: Aspect ratio.
                  additionalProperties: false
                callback_url:
                  type: string
                  nullable: true
                  description: >-
                    Optional public HTTP(S) endpoint for task completion
                    notifications. HTTPS is recommended. Omit, use null, or use
                    an empty string to disable callbacks.
              description: >-
                Keep model and callback_url at the root. Unknown root fields are
                ignored; unsupported input fields are rejected.
            examples:
              basic:
                summary: Basic workflow
                value:
                  model: google/gemini-omni-flash/video-edit
                  input:
                    prompt: >-
                      A quiet forest under soft morning light, with natural
                      detail.
                    video_urls:
                      - https://example.com/video.mp4
                    resolution: 720p
                    aspect_ratio: '16:9'
              callback:
                summary: Receive a completion callback
                value:
                  model: google/gemini-omni-flash/video-edit
                  input:
                    prompt: >-
                      A quiet forest under soft morning light, with natural
                      detail.
                    video_urls:
                      - https://example.com/video.mp4
                    resolution: 720p
                    aspect_ratio: '16:9'
                  callback_url: https://your-domain.com/callback
      responses:
        '200':
          description: Task submitted
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - data
                properties:
                  code:
                    type: integer
                    enum:
                      - 200
                  data:
                    type: object
                    required:
                      - task_id
                      - status
                      - created_time
                    properties:
                      task_id:
                        type: string
                      status:
                        type: string
                        enum:
                          - not_started
                          - running
                          - finished
                          - failed
                      created_time:
                        type: string
                        format: date-time
              example:
                code: 200
                data:
                  task_id: task-unified-example
                  status: running
                  created_time: '2026-09-10T08:00:00'
        '400':
          description: >-
            Invalid input, unsupported tier, inaccessible media, or insufficient
            credits
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '401':
          description: Invalid credentials
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '403':
          description: Access denied
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '404':
          description: Unknown or disabled model
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '408':
          description: Request timed out
          content:
            text/plain:
              schema:
                type: string
              example: Request timeout
        '422':
          description: Invalid JSON or non-object request body
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '429':
          description: Rate or API key credit limit exceeded
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '502':
          description: Unable to create the upstream generation task
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
        '503':
          description: Model configuration or capability is not approved
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    oneOf:
                      - type: string
                      - type: object
                        additionalProperties: true
                      - type: array
                        items: {}
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Use VIDGO_API_KEY.

````