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

# 建立影片（Omni 與 Veo 格式）

> 此系列支援OpenAI影片生成格式（詳見連結 [影片生成Sora相容格式](/api-reference/zh-tw/%E5%BD%B1%E7%89%87%E7%94%9F%E6%88%90sora%E7%9B%B8%E5%AE%B9%E6%A0%BC%E5%BC%8F/%E5%BB%BA%E7%AB%8B%E5%BD%B1%E7%89%87)）。

此介面專題頁用於說明 Omni 與 Veo 相關影片格式，以及目前閘道對 Veo 原生格式的支援狀態。

目前 Veo 系列對外請使用 OpenAI Sora 相容模式：`POST /v1/videos`。

Google 原生模式路徑預留為：`POST /v1beta/models/{model}:predictLongRunning`。目前閘道尚未接通 Veo 原生任務分發鏈路，因此依原生 `instances/parameters` 請求體呼叫暫不支援。

重點：`gemini-omni` 模型支援的端點是 Sora相容格式 `POST /v1/videos` 或 Seedance格式 `POST /api/v3/contents/generations/tasks`；不支援本頁 Google 原生 Veo `predictLongRunning` 端點。



## OpenAPI

````yaml api-reference/zh-tw/openapi.json POST /v1beta/models/{model}:predictLongRunning
openapi: 3.0.0
info:
  title: 出海營 API 參考文件
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: OpenAI格式（Chat）
  - name: OpenAI格式（Responses）
  - name: 圖片生成 Gemini 格式
  - name: 圖片生成OpenAI DALL-E 格式
  - name: 獲取模型列表
  - name: 影片生成HappyHorse與 Wan
  - name: 影片生成Kling格式
  - name: 影片生成 Omni 與 Veo 格式
  - name: 影片生成 Seedance 格式
  - name: 影片生成Sora相容格式
  - name: 影片生成 Vidu 格式
  - name: 音樂生成任務格式
paths:
  /v1beta/models/{model}:predictLongRunning:
    post:
      tags:
        - 影片生成 Omni 與 Veo 格式
      summary: 建立影片（Omni 與 Veo 格式）
      description: >-
        此系列支援OpenAI影片生成格式（詳見連結
        [影片生成Sora相容格式](/api-reference/zh-tw/%E5%BD%B1%E7%89%87%E7%94%9F%E6%88%90sora%E7%9B%B8%E5%AE%B9%E6%A0%BC%E5%BC%8F/%E5%BB%BA%E7%AB%8B%E5%BD%B1%E7%89%87)）。


        此介面專題頁用於說明 Omni 與 Veo 相關影片格式，以及目前閘道對 Veo 原生格式的支援狀態。


        目前 Veo 系列對外請使用 OpenAI Sora 相容模式：`POST /v1/videos`。


        Google 原生模式路徑預留為：`POST
        /v1beta/models/{model}:predictLongRunning`。目前閘道尚未接通 Veo 原生任務分發鏈路，因此依原生
        `instances/parameters` 請求體呼叫暫不支援。


        重點：`gemini-omni` 模型支援的端點是 Sora相容格式 `POST /v1/videos` 或 Seedance格式 `POST
        /api/v3/contents/generations/tasks`；不支援本頁 Google 原生 Veo
        `predictLongRunning` 端點。
      operationId: create_veo3_google_native_task
      parameters:
        - name: model
          in: path
          required: true
          schema:
            type: string
            example: veo3.1-fast
            enum:
              - veo3
              - veo3-fast
              - veo3-fast-frames
              - veo3-frames
              - veo3-pro
              - veo3-pro-frames
              - veo3.1
              - veo3.1-4k
              - veo3.1-components
              - veo3.1-fast
              - veo3.1-pro
              - veo3.1-pro-4k
          description: Veo 模型名稱。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - instances
              properties:
                instances:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      prompt:
                        type: string
                        example: A cinematic aerial shot of a modern city at sunrise
                        description: 生成提示詞
                      referenceImages:
                        type: array
                        description: 選填。1 至 3 張參考圖，使用 Google 原生 `inlineData` 或檔案 URI 結構。
                        items:
                          type: object
                          properties:
                            image:
                              type: object
                              properties:
                                inlineData:
                                  type: object
                                  properties:
                                    mimeType:
                                      type: string
                                      example: image/png
                                    data:
                                      type: string
                                      example: BASE64_IMAGE_DATA
                            referenceType:
                              type: string
                              example: asset
                parameters:
                  type: object
                  properties:
                    aspectRatio:
                      type: string
                      enum:
                        - '16:9'
                        - '1:1'
                        - '9:16'
                      default: '16:9'
                    durationSeconds:
                      type: integer
                      enum:
                        - 5
                        - 6
                        - 8
                        - 10
                      default: 5
                    resolution:
                      type: string
                      example: 720p
            example:
              instances:
                - prompt: A cinematic aerial shot of a modern city at sunrise
                  referenceImages:
                    - image:
                        inlineData:
                          mimeType: image/png
                          data: BASE64_IMAGE_DATA
                      referenceType: asset
              parameters:
                aspectRatio: '16:9'
                durationSeconds: 5
                resolution: 720p
      responses:
        '200':
          description: 預留中的成功回應結構。目前僅作協議說明，不支援實際呼叫。
          content:
            application/json:
              schema:
                type: object
                required:
                  - name
                properties:
                  name:
                    type: string
                    example: models/veo3.1-fast/operations/abc123
                    description: operation name，用於後續狀態查詢。
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        使用 Bearer Token 認證。
        格式: `Authorization: Bearer sk-xxxxxx`

````