> ## 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 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: 影片生成 Seedance 格式 - name: 影片生成Sora相容格式 - name: 影片生成 Vidu 格式 - name: 音樂生成任務格式 paths: /ent/v2/tasks/{task_id}/creations: get: 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: 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` ````