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

# Gemini Omni 1.2 Flash Referenz-zu-Video

> - Gemini Omni 1.2 Flash (`gemini-omni-1.2-flash-reference-to-video`) erzeugt Videos mit nativem Audio aus Referenzbildern, optionalen Referenzvideos und einem Text-Prompt.
- **Bilder:** `image_urls` akzeptiert 1–10 Bilder als Vorgabe für Motive, Stil oder Elemente.
- **Videos:** `video_urls` ist optional, maximal 3 Videos als Referenz für Bewegung, Kameraführung oder Stil. Bei `duration` über 10 Sekunden höchstens 1 Referenzvideo.
- **Auflösung:** `360p`, `720p`, `1080p` oder `4k`; Standard `720p`.
- **Dauer:** `duration` als ganze Sekunden von `3` bis `15`; Standard `3`.
- **Seitenverhältnis:** `16:9`, `9:16` oder `auto`; Standard `auto`.
- Synchronisiertes natives Audio wird automatisch erzeugt, ohne zusätzlichen Parameter.
- Negative Vorgaben direkt in `prompt` schreiben, etwa `No dialogue`; kein separater negativer Prompt.
- Mit `seed` lässt sich die Reproduzierbarkeit verbessern.
- Asynchron: Mit der Aufgaben-ID den [Aufgabenstatus abfragen](/de/api-manual/task-management/get-task-detail).
- Videolinks sind 24 Stunden gültig; bitte rechtzeitig speichern.



## OpenAPI

````yaml de/api-manual/video-series/gemini-omni-1.2-flash/gemini-omni-1.2-flash-reference-to-video.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: Gemini Omni 1.2 Flash Referenz-zu-Video
  description: >-
    Erzeugt aus Referenzbildern, optionalen Referenzvideos und einem Text-Prompt
    ein Video
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Produktionsumgebung
security:
  - bearerAuth: []
paths:
  /v1/videos/generations:
    post:
      tags:
        - Videogenerierung
      summary: Gemini Omni 1.2 Flash Referenz-zu-Video
      description: >-
        - Gemini Omni 1.2 Flash (`gemini-omni-1.2-flash-reference-to-video`)
        erzeugt Videos mit nativem Audio aus Referenzbildern, optionalen
        Referenzvideos und einem Text-Prompt.

        - **Bilder:** `image_urls` akzeptiert 1–10 Bilder als Vorgabe für
        Motive, Stil oder Elemente.

        - **Videos:** `video_urls` ist optional, maximal 3 Videos als Referenz
        für Bewegung, Kameraführung oder Stil. Bei `duration` über 10 Sekunden
        höchstens 1 Referenzvideo.

        - **Auflösung:** `360p`, `720p`, `1080p` oder `4k`; Standard `720p`.

        - **Dauer:** `duration` als ganze Sekunden von `3` bis `15`; Standard
        `3`.

        - **Seitenverhältnis:** `16:9`, `9:16` oder `auto`; Standard `auto`.

        - Synchronisiertes natives Audio wird automatisch erzeugt, ohne
        zusätzlichen Parameter.

        - Negative Vorgaben direkt in `prompt` schreiben, etwa `No dialogue`;
        kein separater negativer Prompt.

        - Mit `seed` lässt sich die Reproduzierbarkeit verbessern.

        - Asynchron: Mit der Aufgaben-ID den [Aufgabenstatus
        abfragen](/de/api-manual/task-management/get-task-detail).

        - Videolinks sind 24 Stunden gültig; bitte rechtzeitig speichern.
      operationId: createGeminiOmni12FlashReferenceToVideoGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GeminiOmni12FlashReferenceToVideoRequest'
            examples:
              reference_to_video:
                summary: Referenz-zu-Video
                value:
                  model: gemini-omni-1.2-flash-reference-to-video
                  prompt: >-
                    Lass die Figur aus dem Referenzbild durch die Referenzszene
                    spazieren.
                  image_urls:
                    - https://example.com/character.png
                    - https://example.com/scene.png
                  quality: 720p
                  aspect_ratio: '16:9'
                  duration: 3
              reference_with_video:
                summary: Bild- und Videoreferenzen
                value:
                  model: gemini-omni-1.2-flash-reference-to-video
                  prompt: >-
                    Lass die Figur aus dem Referenzbild die Bewegungen aus dem
                    Referenzvideo ausführen.
                  image_urls:
                    - https://example.com/character.png
                  video_urls:
                    - https://example.com/reference.mp4
                  quality: 720p
                  aspect_ratio: '16:9'
                  duration: 3
      responses:
        '200':
          description: Videoaufgabe erfolgreich erstellt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
        '400':
          description: Ungültige Anfrageparameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_request
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: Nicht autorisiert, ungültiges oder abgelaufenes Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Unzureichendes Kontingent, Aufladung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: insufficient_quota
                  message: Insufficient quota. Please top up your account.
                  type: insufficient_quota
        '403':
          description: Zugriff verweigert
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: model_access_denied
                  message: >-
                    Token does not have access to model:
                    gemini-omni-1.2-flash-reference-to-video
                  type: invalid_request_error
        '429':
          description: Ratenlimit überschritten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: rate_limit_exceeded
                  message: Too many requests, please try again later
                  type: rate_limit_error
        '500':
          description: Interner Serverfehler
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: internal_error
                  message: Internal server error
                  type: api_error
components:
  schemas:
    GeminiOmni12FlashReferenceToVideoRequest:
      required:
        - model
        - prompt
        - image_urls
      type: object
      additionalProperties: false
      properties:
        model:
          type: string
          description: >-
            Modellname, fest auf `gemini-omni-1.2-flash-reference-to-video`
            eingestellt
          enum:
            - gemini-omni-1.2-flash-reference-to-video
          example: gemini-omni-1.2-flash-reference-to-video
          default: gemini-omni-1.2-flash-reference-to-video
        prompt:
          type: string
          description: >-
            Prompt für Motiv, Stil und Bewegung aus den Referenzen.


            Unterstützt Chinesisch und Englisch. Beschreibe die gewünschte
            Aktion und die Änderungen klar, um stabilere Ergebnisse zu erhalten.
            Negative Vorgaben wie `No dialogue` oder `Kein Text` direkt in
            `prompt` schreiben; es gibt keinen separaten Parameter für negative
            Prompts.


            Der Prompt ist erforderlich und darf weder leer sein noch
            ausschließlich aus Leerraum bestehen.
          example: >-
            Ein Kätzchen spielt mit einem Wollknäuel und stupst es mit den
            Pfoten an.
          minLength: 1
          pattern: \S
        image_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 10
          description: >-
            Array von Referenzbild-URLs. Erforderlich; 1 bis 10 Bilder zur
            Vorgabe von Motiv, Stil oder Elementen.


            **Eingabeanforderungen:**

            - Nur HTTP/HTTPS-Bild-URLs

            - Unterstützte Formate: `png`, `jpeg`, `webp`
          example:
            - https://example.com/character.png
            - https://example.com/scene.png
        video_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 3
          description: >-
            Optionales Array mit Referenzvideos. Höchstens 3; bei `duration`
            über `10` Sekunden höchstens 1.


            Kann mit `image_urls` kombiniert werden, um Bewegung, Kameraführung
            oder Stil vorzugeben.


            **Eingabe:** Nur HTTP/HTTPS-Video-URLs, Format mp4.


            **Abrechnung:** Jedes Referenzvideo wird entsprechend seiner Dauer
            als Eingabe-Tokens berücksichtigt.


            Jedes Referenzvideo darf höchstens `10` Sekunden lang sein.
          example:
            - https://example.com/reference.mp4
        quality:
          type: string
          description: >-
            Videoauflösung; Standard `720p`.


            **Unterstützte Werte:**

            - `360p`: Querformat 640×360 / Hochformat 360×640

            - `720p`: Querformat 1280×720 / Hochformat 720×1280; Standard

            - `1080p`: Querformat 1920×1080 / Hochformat 1080×1920

            - `4k`: Querformat 3840×2160 / Hochformat 2160×3840


            Die Ausrichtung wird durch `aspect_ratio` bestimmt: `16:9` erzeugt
            Querformat, `9:16` Hochformat.


            **Abrechnung:** Ausgabe-Token steigen linear mit der Auflösung.
            Gegenüber `720p` benötigt `360p` etwa ein Drittel, `1080p` etwa das
            1,5-Fache und `4k` etwa das 3-Fache. Die tatsächliche Abrechnung
            richtet sich nach der generierten Nutzung.
          enum:
            - 360p
            - 720p
            - 1080p
            - 4k
          default: 720p
          example: 720p
        duration:
          type: integer
          description: >-
            Videodauer in Sekunden; Standard `3`. Erlaubt sind ganze Zahlen von
            `3` bis `15`. Die Dauer beeinflusst die Abrechnung direkt.
          minimum: 3
          maximum: 15
          default: 3
          example: 3
        aspect_ratio:
          type: string
          description: 'Seitenverhältnis: 16:9, 9:16 oder auto; Standard auto.'
          enum:
            - '16:9'
            - '9:16'
            - auto
          default: auto
          example: auto
        seed:
          type: integer
          description: >-
            Zufalls-Seed; standardmäßig zufällig. Bereich: `0`–`4294967295`. Ein
            fester Seed reduziert beim Optimieren des Prompts Schwankungen durch
            Parameteränderungen und verbessert die Reproduzierbarkeit.
          minimum: 0
          maximum: 4294967295
          example: 42
        callback_url:
          type: string
          description: >-
            HTTPS-Callback-Adresse nach Aufgabenabschluss


            **Callback-Zeitpunkt:**

            - Wird ausgelöst, wenn die Aufgabe abgeschlossen (completed),
            fehlgeschlagen (failed) oder abgebrochen (cancelled) wurde

            - Wird nach Abschluss der Abrechnungsbestätigung gesendet


            **Sicherheitsbeschränkungen:**

            - Nur HTTPS-Protokoll wird unterstützt

            - Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x,
            172.16-31.x.x, 192.168.x.x, usw.)

            - URL-Länge darf `2048` Zeichen nicht überschreiten


            **Callback-Mechanismus:**

            - Timeout: `10` Sekunden

            - Maximal `3` Wiederholungsversuche bei Fehler (Wiederholung nach
            `1` Sekunde/`2` Sekunden/`4` Sekunden)

            - Das Format des Callback-Antwortkörpers entspricht dem
            Antwortformat der Aufgabenabfrage-API

            - Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich,
            andere Statuscodes lösen eine Wiederholung aus
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
      allOf:
        - if:
            properties:
              duration:
                type: integer
                minimum: 11
            required:
              - duration
          then:
            properties:
              video_urls:
                maxItems: 1
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Zeitstempel der Aufgabenerstellung
          example: 1757169743
        id:
          type: string
          description: Aufgaben-ID
          example: task-unified-1757169743-7cvnl5zw
        model:
          type: string
          description: Tatsächlich verwendeter Modellname
          example: gemini-omni-1.2-flash-reference-to-video
        object:
          type: string
          enum:
            - video.generation.task
          description: Spezifischer Aufgabentyp
        progress:
          type: integer
          description: Aufgabenfortschritt in Prozent (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: >-
            Aufgabenstatus. Der Erstellungsendpunkt gibt immer `processing`
            zurück; auch der interne Status `pending` wird Clients als
            `processing` angezeigt.
          enum:
            - pending
            - processing
            - completed
            - failed
          example: processing
        task_info:
          $ref: '#/components/schemas/VideoTaskInfo'
          description: Detaillierte Informationen zur Videoaufgabe
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Aufgaben-Ausgabetyp
          example: video
        usage:
          $ref: '#/components/schemas/Usage'
          description: Nutzungs- und Abrechnungsinformationen
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Fehlercode-Bezeichner
            message:
              type: string
              description: Fehlerbeschreibung
            type:
              type: string
              description: Fehlertyp
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Ob die Aufgabe abgebrochen werden kann
          example: false
        estimated_time:
          type: integer
          description: Geschätzte Abschlusszeit (Sekunden)
          minimum: 0
          example: 60
        video_duration:
          type: integer
          description: Ausgabedauer in Sekunden; entspricht duration.
          example: 3
    Usage:
      type: object
      description: Nutzungs- und Abrechnungsinformationen
      properties:
        billing_rule:
          type: string
          description: Abrechnungsregel
          enum:
            - per_call
            - per_token
            - per_second
          example: per_token
        credits_reserved:
          type: number
          description: Geschätzter Guthabenverbrauch
          minimum: 0
          example: 102.34
        user_group:
          type: string
          description: Abrechnungsgruppe, der der Benutzer angehört
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Alle APIs erfordern Bearer-Token-Authentifizierung##


        **API-Schlüssel erhalten:**


        Besuchen Sie die
        [API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um
        Ihren API-Schlüssel zu erhalten


        **Zum Anfrage-Header hinzufügen:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.