> ## 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/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)）。 Vidu 官方影片生成介面，公開路徑遵循 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；官方格式首尾幀雙圖生影片。 - `Vidu 参考生视频`: 支援模型 viduq3-turbo；官方格式多參考圖生影片。 ## OpenAPI ````yaml api-reference/zh-tw/openapi.json POST /ent/v2/text2video 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: /ent/v2/text2video: post: tags: - 影片生成 Vidu 格式 summary: 建立文生影片(Vidu) 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)）。 Vidu 官方影片生成介面，公開路徑遵循 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；官方格式首尾幀雙圖生影片。 - `Vidu 参考生视频`: 支援模型 viduq3-turbo；官方格式多參考圖生影片。 operationId: createViduTextVideo requestBody: required: true content: application/json: schema: type: object required: - model - prompt 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` ````