> ## 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 POST /ent/v2/reference2video 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/reference2video: post: 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: createViduReferenceVideo requestBody: required: true content: application/json: schema: type: object required: - model - prompt - images properties: model: type: string enum: - viduq3-turbo example: viduq3-turbo description: Vidu の外部向けモデル名。現在公開中の `viduq3-turbo`。 prompt: type: string example: A cinematic product ad with smooth camera motion description: >- 動画生成用プロンプト。テキストから動画生成では必須。画像から動画生成／開始・終了フレーム／参照による動画生成では、業務要件に応じて指定してください。 images: type: array items: type: string format: uri example: - https://example.com/input.jpg description: 画像入力。画像から動画は1枚、開始/終了フレームは2枚、参照画像からの動画生成は1〜7枚。 videos: type: array items: type: string format: uri description: 参考となる生動画は、オプションの動画主体入力です。Vidu の公式モデル機能に従って使用してください。 subjects: type: array items: type: object properties: name: type: string images: type: array items: type: string format: uri videos: type: array items: type: string format: uri voice_id: type: string server_id: type: string description: 生成動画の主体ライブラリ形式を参照して入力します。主体名、画像、動画、音色などのフィールドを含めることができます。 auto_subjects: type: boolean duration: type: integer example: 5 description: 動画の長さ。単位は秒。`viduq3-turbo` 通常は5秒で、公式の範囲に従って設定できます。 resolution: type: string enum: - 540p - 720p - 1080p example: 720p description: 出力解像度。一般的な値は `540p`、`720p`、`1080p` です。 aspect_ratio: type: string enum: - '16:9' - '9:16' - '4:3' - '3:4' - '1:1' example: '16:9' description: '出力のアスペクト比。テキスト生成/参照生成動画でよく使用されます。例: `16:9`、`9:16`、`1:1`。' seed: type: integer description: 乱数シード。 movement_amplitude: type: string enum: - auto - small - medium - large example: auto description: 動作範囲。一般的な値は `auto`、`small`、`medium`、`large` です。 audio: type: boolean description: 音声・映像の直接出力を有効にするかどうか。 audio_type: type: string enum: - all - speech_only - sound_effect_only voice_id: type: string is_rec: type: boolean bgm: type: boolean payload: type: string off_peak: type: boolean description: 生成をオフピークで実行するかどうか。 watermark: type: boolean description: 透かしを追加するかどうか。 wm_position: type: integer enum: - 1 - 2 - 3 - 4 wm_url: type: string format: uri callback_url: type: string format: uri examples: vidu_native_t2v: summary: Vidu テキストから動画を生成 value: model: viduq3-turbo prompt: A cinematic product ad with smooth camera motion duration: 5 resolution: 720p aspect_ratio: '16:9' vidu_native_i2v: summary: Vidu 画像から動画を生成 value: model: viduq3-turbo images: - https://example.com/product.jpg prompt: The product rotates slowly under studio light duration: 5 resolution: 720p vidu_native_start_end: summary: Vidu 先頭・末尾フレームから動画を生成 value: model: viduq3-turbo images: - https://example.com/start.jpg - https://example.com/end.jpg prompt: A smooth camera move from the first frame to the final frame duration: 5 resolution: 720p vidu_native_reference: summary: Vidu 参照生成動画 value: model: viduq3-turbo images: - https://example.com/ref-1.jpg - https://example.com/ref-2.jpg - https://example.com/ref-3.jpg prompt: >- Keep the same character and product style in a cinematic shot duration: 5 resolution: 720p aspect_ratio: '16:9' responses: '200': description: タスクの作成に成功しました content: application/json: schema: type: object required: - task_id - state properties: task_id: type: string description: タスク作成時に返されるタスク ID。タスクの照会に使用します。 state: type: string enum: - created - queueing - processing - success - failed description: >- タスクのステータス。一般的な値は `created`、`queueing`、`processing`、`success`、`failed` です。 model: type: string prompt: type: string images: type: array items: type: string duration: type: integer resolution: type: string created_at: type: string creations: type: string items: type: object properties: url: type: string description: タスク成功後に生成される動画の URL。 cover_url: type: string description: タスク成功後のカバー URL。 watermarked_url: type: string description: ウォーターマーク付き動画のURL。 security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer description: |- Bearer Token を使用して認証します。 形式: `Authorization: Bearer sk-xxxxxx` ````