> ## 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 全パラメータ概要

> - Gemini Omni 1.2 Flashは `POST /v1/videos/generations` から6種類の動画タスクを利用できます。
- **テキストから動画：** `gemini-omni-1.2-flash-text-to-video`。テキストプロンプトのみ必要で、長さは `3〜15` 秒。
- **画像から動画：** `gemini-omni-1.2-flash-image-to-video`。開始フレーム1枚なら `3〜15` 秒、開始・終了の2枚なら `3〜10` 秒。
- **参照素材から動画：** `gemini-omni-1.2-flash-reference-to-video`。参照画像と最大3本の参照動画に対応します。`duration` が10秒を超える場合、参照動画は最大1本です。
- **動画編集：** `gemini-omni-1.2-flash-video-edit`。最大15秒の入力動画1本が必要です。参照画像を最大10枚追加できます。`quality` の既定値は `auto`。
- **動画延長：** `gemini-omni-1.2-flash-video-extend`。最大30秒の動画1本が必要です。参照画像を最大10枚追加できます。`quality` の既定値は `auto`、`duration` は追加する秒数です。
- **動画アップスケール：** `gemini-omni-1.2-flash-video-upscale`。対応する標準サイズの最大15秒の動画1本が必要です。`quality` で目標解像度を指定し、プロンプトは不要です。
- **アスペクト比：** 既定値は `auto`。編集・延長・アップスケールでは入力動画の比率を維持します。
- 同期したネイティブ音声を自動生成します。追加の切り替え設定は不要です。
- `seed` の固定で再現性を高められます。
- 非同期処理です。タスクIDで[状態を確認](/ja/api-manual/task-management/get-task-detail)してください。
- 生成動画のリンクは24時間有効です。早めに保存してください。



## OpenAPI

````yaml ja/api-manual/video-series/gemini-omni-1.2-flash/gemini-omni-1.2-flash-overview.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: Gemini Omni 1.2 Flash 全パラメータ概要
  description: >-
    Gemini Omni 1.2
    Flashの全パラメータ概要。テキストから動画、画像から動画、参照素材から動画、動画編集、動画延長、動画アップスケールの6モードを扱います。
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: 本番環境
security:
  - bearerAuth: []
paths:
  /v1/videos/generations:
    post:
      tags:
        - 動画生成
      summary: Gemini Omni 1.2 Flash 全パラメータ概要
      description: >-
        - Gemini Omni 1.2 Flashは `POST /v1/videos/generations`
        から6種類の動画タスクを利用できます。

        - **テキストから動画：** `gemini-omni-1.2-flash-text-to-video`。テキストプロンプトのみ必要で、長さは
        `3〜15` 秒。

        - **画像から動画：** `gemini-omni-1.2-flash-image-to-video`。開始フレーム1枚なら `3〜15`
        秒、開始・終了の2枚なら `3〜10` 秒。

        - **参照素材から動画：**
        `gemini-omni-1.2-flash-reference-to-video`。参照画像と最大3本の参照動画に対応します。`duration`
        が10秒を超える場合、参照動画は最大1本です。

        - **動画編集：**
        `gemini-omni-1.2-flash-video-edit`。最大15秒の入力動画1本が必要です。参照画像を最大10枚追加できます。`quality`
        の既定値は `auto`。

        - **動画延長：**
        `gemini-omni-1.2-flash-video-extend`。最大30秒の動画1本が必要です。参照画像を最大10枚追加できます。`quality`
        の既定値は `auto`、`duration` は追加する秒数です。

        - **動画アップスケール：**
        `gemini-omni-1.2-flash-video-upscale`。対応する標準サイズの最大15秒の動画1本が必要です。`quality`
        で目標解像度を指定し、プロンプトは不要です。

        - **アスペクト比：** 既定値は `auto`。編集・延長・アップスケールでは入力動画の比率を維持します。

        - 同期したネイティブ音声を自動生成します。追加の切り替え設定は不要です。

        - `seed` の固定で再現性を高められます。

        -
        非同期処理です。タスクIDで[状態を確認](/ja/api-manual/task-management/get-task-detail)してください。

        - 生成動画のリンクは24時間有効です。早めに保存してください。
      operationId: createGeminiOmni12FlashGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GeminiOmni12FlashRequest'
            examples:
              text_to_video:
                summary: テキストから動画
                value:
                  model: gemini-omni-1.2-flash-text-to-video
                  prompt: ガラス玉が木製のコースを勢いよく転がり、最後に水へ落ちてしぶきを上げる。
                  quality: 720p
                  duration: 3
                  aspect_ratio: '16:9'
              image_to_video:
                summary: 開始・終了フレームから動画
                value:
                  model: gemini-omni-1.2-flash-image-to-video
                  prompt: 日の出の映像から夜の灯りへ滑らかに切り替える。
                  image_urls:
                    - https://example.com/first-frame.png
                    - https://example.com/last-frame.png
                  quality: 720p
                  duration: 3
                  aspect_ratio: '16:9'
              reference_to_video:
                summary: 参照素材から動画
                value:
                  model: gemini-omni-1.2-flash-reference-to-video
                  prompt: 参照画像の人物の外見を維持し、参照動画のカメラの動きを取り入れる。
                  image_urls:
                    - https://example.com/character.png
                  video_urls:
                    - https://example.com/reference.mp4
                  quality: 720p
                  duration: 3
                  aspect_ratio: '16:9'
              video_edit:
                summary: 動画編集
                value:
                  model: gemini-omni-1.2-flash-video-edit
                  prompt: 全体の照明を暖かい夕日の雰囲気にし、その他の内容は変更しない。
                  video_urls:
                    - https://example.com/source.mp4
                  quality: auto
                  duration: auto
                  aspect_ratio: auto
              video_extend:
                summary: 動画延長
                value:
                  model: gemini-omni-1.2-flash-video-extend
                  prompt: 人物が前へ歩き続け、ゆっくりと画面の外へ出ていく。
                  video_urls:
                    - https://example.com/source.mp4
                  duration: 3
                  quality: auto
                  aspect_ratio: auto
              video_upscale:
                summary: 動画アップスケール
                value:
                  model: gemini-omni-1.2-flash-video-upscale
                  video_urls:
                    - https://example.com/source-720p.mp4
                  quality: 1080p
      responses:
        '200':
          description: 動画タスクの作成に成功しました
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
        '400':
          description: リクエストパラメータエラー
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_request
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: 未認証、Tokenが無効または期限切れ
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: 残高不足、チャージが必要
          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: アクセス権限がありません
          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-text-to-video
                  type: invalid_request_error
        '429':
          description: リクエスト頻度が上限を超えました
          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: サーバー内部エラー
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: internal_error
                  message: Internal server error
                  type: api_error
components:
  schemas:
    GeminiOmni12FlashRequest:
      type: object
      required:
        - model
      additionalProperties: false
      properties:
        model:
          type: string
          description: |-
            モデル名。入力素材とタスクに応じたモデルIDを選択してください。

            - `gemini-omni-1.2-flash-text-to-video`：テキストから動画
            - `gemini-omni-1.2-flash-image-to-video`：画像から動画（開始フレーム、または開始・終了フレーム）
            - `gemini-omni-1.2-flash-reference-to-video`：参照素材から動画
            - `gemini-omni-1.2-flash-video-edit`：動画編集
            - `gemini-omni-1.2-flash-video-extend`：動画延長
            - `gemini-omni-1.2-flash-video-upscale`：動画アップスケール
          enum:
            - gemini-omni-1.2-flash-text-to-video
            - gemini-omni-1.2-flash-image-to-video
            - gemini-omni-1.2-flash-reference-to-video
            - gemini-omni-1.2-flash-video-edit
            - gemini-omni-1.2-flash-video-extend
            - gemini-omni-1.2-flash-video-upscale
          example: gemini-omni-1.2-flash-text-to-video
        prompt:
          type: string
          description: >-
            生成・編集・続きの内容を指定するテキストプロンプト。中国語と英語に対応します。アップスケール以外は必須です。アップスケールではプロンプトは不要です。


            - 被写体、動作、場面、カメラの動き、変更せずに保つ内容を明確に記述してください。

            - 否定的な指定は直接記述します（例：`No
            dialogue`、`文字を表示しない`）。独立したネガティブプロンプトのパラメータはありません。


            動画アップスケールでは `prompt` を使用しません。指定しても無視されます。
          example: ガラス玉が木製のコースを勢いよく転がり、最後に水へ落ちてしぶきを上げる。
        image_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 10
          description: |-
            入力画像の配列。

            - 画像から動画：必須、1〜2枚。1枚なら開始フレーム、2枚なら開始・終了フレームです。
            - 参照素材から動画：必須。公開されている推奨上限は参照画像10枚です。
            - 動画編集：任意、参照画像は最大10枚。
            - 動画延長：任意、参照画像は最大10枚。
            - テキストから動画・アップスケール：画像入力は非対応。

            HTTP/HTTPS画像URLのみ。形式：`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: >-
            入力動画の配列。


            - 参照素材から動画：任意。公開されている推奨上限は3本。`duration` が10秒を超える場合は最大1本。

            - 動画編集：1本必須、最大15秒。

            - 動画延長：1本必須、最大30秒。

            - アップスケール：1本必須、最大15秒。サイズは `640×360`、`1280×720`、`1920×1080`
            と、それぞれの縦向きサイズのみ。

            - テキストから動画・画像から動画：動画入力は非対応。


            各参照動画の長さは `10` 秒以下である必要があります。
          example:
            - https://example.com/reference.mp4
        quality:
          type: string
          description: >-
            動画の解像度。


            **選択肢（横向き / 縦向き）：**

            - `360p`：640×360 / 360×640

            - `720p`：1280×720 / 720×1280

            - `1080p`：1920×1080 / 1080×1920

            - `4k`：3840×2160 / 2160×3840

            - `auto`：編集・延長のみ。入力動画の解像度に合わせます。


            **既定値：**

            - テキスト・画像・参照素材から動画：`720p`。

            - 動画編集・延長：`auto`。

            - アップスケール：目標解像度の指定が必須で、入力より高い必要があります。360p → `720p` または `1080p`、720p
            → `1080p` または `4k`、1080p → `4k`。


            **課金について：**
            テキスト・画像・参照素材からの動画生成、編集、延長では、入力トークン、動画出力トークン、その他の出力トークン（思考を含む）が個別に課金されます。動画アップスケールでは動画出力トークンのみが課金され、入力トークンや思考トークンの料金は発生しません。送信時の料金は見積額であり、最終的な料金は実際の使用量に基づいて精算されます。
          enum:
            - 360p
            - 720p
            - 1080p
            - 4k
            - auto
          example: 720p
        duration:
          description: |-
            動画の長さ。

            - テキスト・参照素材から動画：`3`〜`15` 秒の整数。既定値 `3`。
            - 画像から動画：開始フレーム1枚なら `3`〜`15` 秒、開始・終了の2枚なら `3`〜`10` 秒。既定値 `3`。
            - 動画編集・アップスケール：`auto` のみで、既定値も `auto`。入力動画の長さに合わせます。
            - 動画延長：`3`〜`10` 秒の整数。既定値 `3`。追加する長さを表します。
          oneOf:
            - type: integer
              minimum: 3
              maximum: 15
            - type: string
              enum:
                - auto
          example: 3
        aspect_ratio:
          type: string
          description: |-
            動画のアスペクト比。既定値は `auto`。

            - `16:9`：横向き。
            - `9:16`：縦向き。
            - `auto`：プロンプトと素材に基づいてモデルが決定します。既定値です。

            編集・延長・アップスケールは `auto` のみ指定でき、入力動画の比率を維持します。
          enum:
            - '16:9'
            - '9:16'
            - auto
          default: auto
          example: auto
        seed:
          type: integer
          description: >-
            乱数シード。既定ではランダムです。範囲は
            `0`〜`4294967295`。シードを固定すると、プロンプト調整時のパラメータ変更によるばらつきを抑え、再現性を高められます。
          minimum: 0
          maximum: 4294967295
          example: 42
        callback_url:
          type: string
          description: >-
            タスク完了後のHTTPSコールバックアドレス


            **コールバックのタイミング：**

            - タスクの完了（completed）、失敗（failed）、キャンセル（cancelled）時にトリガーされます

            - 課金確定後に送信されます


            **セキュリティ制限：**

            - HTTPSプロトコルのみ対応

            - 内部ネットワークIPアドレス（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x
            など）へのコールバックは禁止

            - URLの長さは `2048` 文字以内


            **コールバックの仕組み：**

            - タイムアウト時間：`10` 秒

            - 失敗後は最大 `3` 回まで再試行します（失敗後それぞれ `1` 秒／`2` 秒／`4` 秒後に再試行します）

            - コールバックのレスポンスボディの形式はタスク照会インターフェースの返却形式と同一です

            - コールバックアドレスが2xxステータスコードを返した場合は成功とみなし、それ以外のステータスコードは再試行をトリガーします
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
      allOf:
        - if:
            properties:
              model:
                const: gemini-omni-1.2-flash-text-to-video
            required:
              - model
          then:
            properties:
              duration:
                type: integer
                default: 3
                minimum: 3
                maximum: 15
              quality:
                enum:
                  - 360p
                  - 720p
                  - 1080p
                  - 4k
                default: 720p
              prompt:
                minLength: 1
                pattern: \S
            not:
              anyOf:
                - required:
                    - image_urls
                - required:
                    - video_urls
            required:
              - prompt
        - if:
            properties:
              model:
                const: gemini-omni-1.2-flash-image-to-video
            required:
              - model
          then:
            required:
              - prompt
              - image_urls
            properties:
              image_urls:
                maxItems: 2
              duration:
                type: integer
                default: 3
                minimum: 3
                maximum: 15
              quality:
                enum:
                  - 360p
                  - 720p
                  - 1080p
                  - 4k
                default: 720p
              prompt:
                minLength: 1
                pattern: \S
            not:
              anyOf:
                - required:
                    - video_urls
            allOf:
              - if:
                  properties:
                    image_urls:
                      minItems: 2
                  required:
                    - image_urls
                then:
                  properties:
                    duration:
                      maximum: 10
        - if:
            properties:
              model:
                const: gemini-omni-1.2-flash-reference-to-video
            required:
              - model
          then:
            required:
              - prompt
              - image_urls
            properties:
              video_urls:
                maxItems: 3
              duration:
                type: integer
                default: 3
                minimum: 3
                maximum: 15
              quality:
                enum:
                  - 360p
                  - 720p
                  - 1080p
                  - 4k
                default: 720p
              prompt:
                minLength: 1
                pattern: \S
            allOf:
              - if:
                  properties:
                    duration:
                      type: integer
                      minimum: 11
                  required:
                    - duration
                then:
                  properties:
                    video_urls:
                      maxItems: 1
        - if:
            properties:
              model:
                const: gemini-omni-1.2-flash-video-edit
            required:
              - model
          then:
            required:
              - prompt
              - video_urls
            properties:
              video_urls:
                maxItems: 1
              image_urls:
                maxItems: 10
              duration:
                type: string
                enum:
                  - auto
                default: auto
              aspect_ratio:
                enum:
                  - auto
              quality:
                enum:
                  - 360p
                  - 720p
                  - 1080p
                  - 4k
                  - auto
                default: auto
              prompt:
                minLength: 1
                pattern: \S
        - if:
            properties:
              model:
                const: gemini-omni-1.2-flash-video-extend
            required:
              - model
          then:
            required:
              - prompt
              - video_urls
            properties:
              video_urls:
                maxItems: 1
              image_urls:
                maxItems: 10
              duration:
                type: integer
                default: 3
                minimum: 3
                maximum: 10
              aspect_ratio:
                enum:
                  - auto
              quality:
                enum:
                  - 360p
                  - 720p
                  - 1080p
                  - 4k
                  - auto
                default: auto
              prompt:
                minLength: 1
                pattern: \S
        - if:
            properties:
              model:
                const: gemini-omni-1.2-flash-video-upscale
            required:
              - model
          then:
            required:
              - video_urls
              - quality
            properties:
              video_urls:
                maxItems: 1
              quality:
                enum:
                  - 720p
                  - 1080p
                  - 4k
              duration:
                type: string
                enum:
                  - auto
                default: auto
              aspect_ratio:
                enum:
                  - auto
                default: auto
            not:
              required:
                - image_urls
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: タスク作成のタイムスタンプ
          example: 1757169743
        id:
          type: string
          description: タスクID
          example: task-unified-1757169743-7cvnl5zw
        model:
          type: string
          description: 実際に使用されたモデル名
          example: gemini-omni-1.2-flash-text-to-video
        object:
          type: string
          enum:
            - video.generation.task
          description: タスクの具体的な種別
        progress:
          type: integer
          description: タスクの進捗率 (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: >-
            タスクの状態。作成APIは常に `processing` を返します。内部状態の `pending` もクライアントには
            `processing` として公開されます。
          enum:
            - pending
            - processing
            - completed
            - failed
          example: processing
        task_info:
          $ref: '#/components/schemas/VideoTaskInfo'
          description: 動画タスクの詳細情報
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: タスクの出力タイプ
          example: video
        usage:
          $ref: '#/components/schemas/Usage'
          description: 使用量と課金情報
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: エラーコード識別子
            message:
              type: string
              description: エラーの説明情報
            type:
              type: string
              description: エラーの種類
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: タスクがキャンセル可能かどうか
          example: false
        estimated_time:
          type: integer
          description: 完了までの推定時間（秒）
          minimum: 0
          example: 60
        video_duration:
          type: integer
          description: >-
            出力動画の長さ（秒）。


            - テキスト・画像・参照素材から動画：リクエストの `duration` と同じ。

            - 動画編集：`duration` は既定値の `auto`
            のみ指定できます。出力は入力に従い、この項目には検出された入力動画の長さが返されます。

            - 動画延長：入力動画の長さに追加の `duration` を足した出力全体の長さ。

            - アップスケール：入力と同じ。検出された入力動画の長さが返されます。
          example: 3
    Usage:
      type: object
      description: 使用量と課金情報
      properties:
        billing_rule:
          type: string
          description: 課金ルール
          enum:
            - per_call
            - per_token
            - per_second
          example: per_token
        credits_reserved:
          type: number
          description: 消費が見込まれるクレジット数
          minimum: 0
          example: 102.34
        user_group:
          type: string
          description: ユーザーが所属する課金グループ
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##すべてのインターフェースはBearer Tokenによる認証が必要です##


        **API Key の取得：**


        [API Key 管理ページ](https://evolink.ai/dashboard/keys) にアクセスして API Key
        を取得してください


        **利用時はリクエストヘッダーに以下を追加します：**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

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