> ## 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.

# タスクを照会する(Vidu)

> このシリーズはOpenAIの動画生成形式をサポートしています（詳細はリンク [動画生成Sora互換形式](/api-reference/ja/video-generation-sora-compatible-format/create-video) を参照してください）。

Vidu 公式動画生成API。公開パスは Vidu 公式仕様に準拠します。

現在公開されているモデル：`viduq3-turbo`。テキストから動画、画像から動画、開始・終了フレームから動画、参考動画から動画に対応しています。同一モデルは `/v1/videos` Sora 互換形式でも接続でき、一般的な `mode` は `t2v`、`i2v`、`i2v_first_last`、`reference_images` です。

Vidu 公式動画生成フォーマットの公開リクエスト骨格、タスク照会構造、推奨検証テンプレートを補足します。公開パスは Vidu 公式エンドポイント形式を維持します。

対応モデル：
viduq3-turbo

共通リクエストフィールド：
- `model` (string, 必須): Vidu の対外公開モデル名。現在公開中の `viduq3-turbo`。
- `prompt` (string, 任意): 動画生成プロンプト。テキストから動画では必須、画像から/開始・終了フレーム/参考動画からは業務要件に応じて送信します。
- `images` (array[string], 任意): 画像入力。画像から動画は1枚、開始・終了フレームは2枚、参考動画からは1〜7枚。
- `videos` (array[string], 任意): 参考動画から動画で使用できる動画主体入力。Vidu 公式モデルの機能に応じて使用します。
- `subjects` (array[object], 任意): 参考動画から動画の主体ライブラリ形式の入力。主体名、画像、動画、音色などのフィールドを含めることができます。
- `duration` (integer, 任意): 動画の長さ。単位は秒です。`viduq3-turbo` は通常 5 秒で、公式の範囲に従って設定できます。
- `resolution` (string, 任意): 出力解像度。一般的な値は `540p`、`720p`、`1080p` です。
- `aspect_ratio` (string, 任意): 出力アスペクト比。テキストから動画/参考動画から動画で一般的に使用されます。例: `16:9`、`9:16`、`1:1`。
- `seed` (integer, 任意): 乱数シード。
- `movement_amplitude` (string, 任意): モーションの強さ。一般的な値は `auto`、`small`、`medium`、`large` です。
- `audio` (boolean, 任意): 音声付き動画の直接出力を有効にするかどうか。
- `off_peak` (boolean, 任意): オフピーク生成を使用するかどうか。
- `watermark` (boolean, 任意): ウォーターマークを追加するかどうか。

代表的なモデル/モードの違い：
- `Vidu 文生视频`: サポートモデル viduq3-turbo；公式形式のテキストから動画。
- `Vidu 图生视频`: サポートモデル viduq3-turbo；公式形式の単一画像から動画。
- `Vidu 首尾帧生视频`: サポートモデル viduq3-turbo；公式形式の開始・終了フレームの2画像から動画。
- `Vidu 参考生视频`: サポートモデル viduq3-turbo；公式形式の複数参考画像から動画。



## OpenAPI

````yaml api-reference/ja/openapi.json GET /ent/v2/tasks/{task_id}/creations
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: Video generation Seedance
  - name: 動画生成Sora対応形式
  - name: Video generation Vidu
  - name: 音楽生成タスクの形式
paths:
  /ent/v2/tasks/{task_id}/creations:
    get:
      tags:
        - Video generation Vidu
      summary: タスクを照会する(Vidu)
      description: >-
        このシリーズはOpenAIの動画生成形式をサポートしています（詳細はリンク
        [動画生成Sora互換形式](/api-reference/ja/video-generation-sora-compatible-format/create-video)
        を参照してください）。


        Vidu 公式動画生成API。公開パスは Vidu 公式仕様に準拠します。


        現在公開されているモデル：`viduq3-turbo`。テキストから動画、画像から動画、開始・終了フレームから動画、参考動画から動画に対応しています。同一モデルは
        `/v1/videos` Sora 互換形式でも接続でき、一般的な `mode` は
        `t2v`、`i2v`、`i2v_first_last`、`reference_images` です。


        Vidu 公式動画生成フォーマットの公開リクエスト骨格、タスク照会構造、推奨検証テンプレートを補足します。公開パスは Vidu
        公式エンドポイント形式を維持します。


        対応モデル：

        viduq3-turbo


        共通リクエストフィールド：

        - `model` (string, 必須): Vidu の対外公開モデル名。現在公開中の `viduq3-turbo`。

        - `prompt` (string, 任意):
        動画生成プロンプト。テキストから動画では必須、画像から/開始・終了フレーム/参考動画からは業務要件に応じて送信します。

        - `images` (array[string], 任意): 画像入力。画像から動画は1枚、開始・終了フレームは2枚、参考動画からは1〜7枚。

        - `videos` (array[string], 任意): 参考動画から動画で使用できる動画主体入力。Vidu
        公式モデルの機能に応じて使用します。

        - `subjects` (array[object], 任意):
        参考動画から動画の主体ライブラリ形式の入力。主体名、画像、動画、音色などのフィールドを含めることができます。

        - `duration` (integer, 任意): 動画の長さ。単位は秒です。`viduq3-turbo` は通常 5
        秒で、公式の範囲に従って設定できます。

        - `resolution` (string, 任意): 出力解像度。一般的な値は `540p`、`720p`、`1080p` です。

        - `aspect_ratio` (string, 任意): 出力アスペクト比。テキストから動画/参考動画から動画で一般的に使用されます。例:
        `16:9`、`9:16`、`1:1`。

        - `seed` (integer, 任意): 乱数シード。

        - `movement_amplitude` (string, 任意): モーションの強さ。一般的な値は
        `auto`、`small`、`medium`、`large` です。

        - `audio` (boolean, 任意): 音声付き動画の直接出力を有効にするかどうか。

        - `off_peak` (boolean, 任意): オフピーク生成を使用するかどうか。

        - `watermark` (boolean, 任意): ウォーターマークを追加するかどうか。


        代表的なモデル/モードの違い：

        - `Vidu 文生视频`: サポートモデル viduq3-turbo；公式形式のテキストから動画。

        - `Vidu 图生视频`: サポートモデル viduq3-turbo；公式形式の単一画像から動画。

        - `Vidu 首尾帧生视频`: サポートモデル viduq3-turbo；公式形式の開始・終了フレームの2画像から動画。

        - `Vidu 参考生视频`: サポートモデル viduq3-turbo；公式形式の複数参考画像から動画。
      operationId: queryViduTaskCreations
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: タスク ID。タスク作成の応答で返される `task_id` から取得します。
      responses:
        '200':
          description: 照会に成功しました
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: タスク ID。
                  state:
                    type: string
                    enum:
                      - created
                      - queueing
                      - processing
                      - success
                      - failed
                    description: >-
                      タスクのステータス。一般的な値は
                      `created`、`queueing`、`processing`、`success`、`failed` です。
                  err_code:
                    type: string
                  payload:
                    type: string
                  creations:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        url:
                          type: string
                          format: uri
                          description: タスク成功後に生成される動画の URL。
                        cover_url:
                          type: string
                          format: uri
                          description: タスク成功後のカバー URL。
                        watermarked_url:
                          type: string
                          format: uri
                          description: ウォーターマーク付き動画のURL。
                  task_id:
                    type: string
                    description: タスク作成時に返されるタスク ID。タスクの照会に使用します。
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Bearer Token を使用して認証します。
        形式: `Authorization: Bearer sk-xxxxxx`

````