> ## 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. # Tạo video sinh tham chiếu(Vidu) > Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết [Định dạng tương thích với Sora tạo video](/api-reference/vi/tao-video-dinh-dang-tuong-thich-sora/tao-video)). Vidu giao diện tạo video chính thức, đường dẫn công khai tuân theo giao thức chính thức của Vidu. Mô hình công khai hiện tại: `viduq3-turbo`. Hỗ trợ text-to-video, image-to-video, video từ khung đầu-cuối, và reference-to-video. Cùng một mô hình cũng hỗ trợ tích hợp thông qua định dạng tương thích Sora của `/v1/videos`, các `mode` thường dùng là `t2v`, `i2v`, `i2v_first_last`, `reference_images`. Bổ sung skeleton request công khai, cấu trúc truy vấn tác vụ và mẫu xác minh được khuyến nghị cho định dạng tạo video chính thức của Vidu, đường dẫn công khai giữ nguyên định dạng endpoint chính thức của Vidu. Mô hình hỗ trợ: viduq3-turbo Các trường yêu cầu thống nhất: - `model` (string, bắt buộc): tên mô hình công khai của Vidu, hiện công khai `viduq3-turbo`. - `prompt` (string, tùy chọn): prompt tạo video; bắt buộc với text-to-video, còn image-to-video/khung đầu-cuối/reference-to-video thì truyền theo nhu cầu nghiệp vụ. - `images` (array[string], tùy chọn): đầu vào hình ảnh. image-to-video dùng 1 ảnh, khung đầu-cuối dùng 2 ảnh, reference-to-video dùng 1~7 ảnh. - `videos` (array[string], tùy chọn): đầu vào đối tượng video tùy chọn cho reference-to-video, sử dụng theo năng lực mô hình chính thức của Vidu. - `subjects` (array[object], tùy chọn): đầu vào theo định dạng thư viện chủ thể của reference-to-video, có thể bao gồm các trường như tên chủ thể, ảnh, video hoặc giọng. - `duration` (integer, tùy chọn): độ dài video, tính bằng giây. `viduq3-turbo` thường dùng 5 giây, có thể đặt theo phạm vi chính thức. - `resolution` (string, tùy chọn): độ phân giải đầu ra, giá trị phổ biến `540p`, `720p`, `1080p`. - `aspect_ratio` (string, tùy chọn): tỷ lệ khung hình đầu ra, thường dùng cho text-to-video/reference-to-video, như `16:9`, `9:16`, `1:1`. - `seed` (integer, tùy chọn): Seed ngẫu nhiên. - `movement_amplitude` (string, tùy chọn): mức độ chuyển động, các giá trị phổ biến `auto`, `small`, `medium`, `large`. - `audio` (boolean, tùy chọn): có bật xuất trực tiếp âm thanh và video hay không. - `off_peak` (boolean, tùy chọn): có sử dụng tạo lệch giờ hay không. - `watermark` (boolean, tùy chọn): Có thêm watermark hay không. Khác biệt thường gặp giữa mô hình/chế độ: - `Vidu 文生视频`: hỗ trợ mô hình viduq3-turbo; text-to-video theo định dạng chính thức. - `Vidu 图生视频`: hỗ trợ mô hình viduq3-turbo; image-to-video một ảnh theo định dạng chính thức. - `Vidu 首尾帧生视频`: hỗ trợ mô hình viduq3-turbo; video từ hai ảnh khung đầu-cuối theo định dạng chính thức. - `Vidu 参考生视频`: hỗ trợ mô hình viduq3-turbo; reference-to-video với nhiều ảnh tham chiếu theo định dạng chính thức. ## OpenAPI ````yaml api-reference/vi/openapi.json POST /ent/v2/reference2video openapi: 3.0.0 info: title: Tài liệu tham khảo API của 出海营 version: 1.0.0 description: Public AI Gateway API Reference servers: - url: https://api.aiid.edu.kg security: - BearerAuth: [] tags: - name: Định dạng OpenAI (Chat) - name: Định dạng OpenAI (Responses) - name: Định dạng Gemini cho tạo ảnh - name: Tạo hình ảnhOpenAI định dạng DALL-E - name: Lấy danh sách mô hình - name: Tạo video HappyHorse và Wan - name: Định dạngKling tạo video - name: Định dạng Video Generation Omni và Veo - name: Tạo video Seedance - name: Định dạng tương thích Sora cho tạo video - name: Tạo video Vidu - name: Định dạng tác vụ tạo nhạc paths: /ent/v2/reference2video: post: tags: - Tạo video Vidu summary: Tạo video sinh tham chiếu(Vidu) description: >- Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết [Định dạng tương thích với Sora tạo video](/api-reference/vi/tao-video-dinh-dang-tuong-thich-sora/tao-video)). Vidu giao diện tạo video chính thức, đường dẫn công khai tuân theo giao thức chính thức của Vidu. Mô hình công khai hiện tại: `viduq3-turbo`. Hỗ trợ text-to-video, image-to-video, video từ khung đầu-cuối, và reference-to-video. Cùng một mô hình cũng hỗ trợ tích hợp thông qua định dạng tương thích Sora của `/v1/videos`, các `mode` thường dùng là `t2v`, `i2v`, `i2v_first_last`, `reference_images`. Bổ sung skeleton request công khai, cấu trúc truy vấn tác vụ và mẫu xác minh được khuyến nghị cho định dạng tạo video chính thức của Vidu, đường dẫn công khai giữ nguyên định dạng endpoint chính thức của Vidu. Mô hình hỗ trợ: viduq3-turbo Các trường yêu cầu thống nhất: - `model` (string, bắt buộc): tên mô hình công khai của Vidu, hiện công khai `viduq3-turbo`. - `prompt` (string, tùy chọn): prompt tạo video; bắt buộc với text-to-video, còn image-to-video/khung đầu-cuối/reference-to-video thì truyền theo nhu cầu nghiệp vụ. - `images` (array[string], tùy chọn): đầu vào hình ảnh. image-to-video dùng 1 ảnh, khung đầu-cuối dùng 2 ảnh, reference-to-video dùng 1~7 ảnh. - `videos` (array[string], tùy chọn): đầu vào đối tượng video tùy chọn cho reference-to-video, sử dụng theo năng lực mô hình chính thức của Vidu. - `subjects` (array[object], tùy chọn): đầu vào theo định dạng thư viện chủ thể của reference-to-video, có thể bao gồm các trường như tên chủ thể, ảnh, video hoặc giọng. - `duration` (integer, tùy chọn): độ dài video, tính bằng giây. `viduq3-turbo` thường dùng 5 giây, có thể đặt theo phạm vi chính thức. - `resolution` (string, tùy chọn): độ phân giải đầu ra, giá trị phổ biến `540p`, `720p`, `1080p`. - `aspect_ratio` (string, tùy chọn): tỷ lệ khung hình đầu ra, thường dùng cho text-to-video/reference-to-video, như `16:9`, `9:16`, `1:1`. - `seed` (integer, tùy chọn): Seed ngẫu nhiên. - `movement_amplitude` (string, tùy chọn): mức độ chuyển động, các giá trị phổ biến `auto`, `small`, `medium`, `large`. - `audio` (boolean, tùy chọn): có bật xuất trực tiếp âm thanh và video hay không. - `off_peak` (boolean, tùy chọn): có sử dụng tạo lệch giờ hay không. - `watermark` (boolean, tùy chọn): Có thêm watermark hay không. Khác biệt thường gặp giữa mô hình/chế độ: - `Vidu 文生视频`: hỗ trợ mô hình viduq3-turbo; text-to-video theo định dạng chính thức. - `Vidu 图生视频`: hỗ trợ mô hình viduq3-turbo; image-to-video một ảnh theo định dạng chính thức. - `Vidu 首尾帧生视频`: hỗ trợ mô hình viduq3-turbo; video từ hai ảnh khung đầu-cuối theo định dạng chính thức. - `Vidu 参考生视频`: hỗ trợ mô hình viduq3-turbo; reference-to-video với nhiều ảnh tham chiếu theo định dạng chính thức. 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 là tên mô hình công khai ra bên ngoài, hiện tại công khai `viduq3-turbo`. prompt: type: string example: A cinematic product ad with smooth camera motion description: >- Câu lệnh gợi ý tạo video; bắt buộc với văn bản thành video, với ảnh thành video/khung đầu-cuối/video tham chiếu thì truyền theo nhu cầu nghiệp vụ. images: type: array items: type: string format: uri example: - https://example.com/input.jpg description: >- Đầu vào hình ảnh. Tạo video từ ảnh: 1 ảnh; khung đầu và khung cuối: 2 ảnh; tạo video tham chiếu: 1~7 ảnh. videos: type: array items: type: string format: uri description: >- Tham khảo đầu vào chủ thể video tùy chọn để tạo video, sử dụng theo khả năng của mô hình chính thức 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: >- Nhập theo định dạng thư viện chủ thể video sinh tham khảo, có thể bao gồm các trường như tên chủ thể, ảnh, video hoặc giọng điệu. auto_subjects: type: boolean duration: type: integer example: 5 description: >- Thời lượng video, tính bằng giây. `viduq3-turbo` Thường dùng 5 giây, có thể đặt theo phạm vi chính thức. resolution: type: string enum: - 540p - 720p - 1080p example: 720p description: >- Độ phân giải đầu ra, các giá trị thường gặp là `540p`, `720p`, `1080p`. aspect_ratio: type: string enum: - '16:9' - '9:16' - '4:3' - '3:4' - '1:1' example: '16:9' description: >- Tỷ lệ khung hình đầu ra, thường dùng cho video tạo từ văn bản/tham chiếu, như `16:9`, `9:16`, `1:1`. seed: type: integer description: Hạt giống ngẫu nhiên. movement_amplitude: type: string enum: - auto - small - medium - large example: auto description: >- Biên độ chuyển động, các giá trị thường gặp `auto`、`small`、`medium`、`large`。 audio: type: boolean description: Có bật xuất trực tiếp âm thanh và video hay không. 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: Có sử dụng tạo lệch thời gian không. watermark: type: boolean description: Có thêm hình mờ hay không. 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 Tạo video từ văn bản 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 Tạo video từ ảnh 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 Tạo video từ khung đầu và khung cuối 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 video tham chiếu được tạo 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: Tạo nhiệm vụ thành công content: application/json: schema: type: object required: - task_id - state properties: task_id: type: string description: >- ID tác vụ được trả về khi tạo tác vụ, dùng để truy vấn tác vụ. state: type: string enum: - created - queueing - processing - success - failed description: >- Trạng thái tác vụ, các giá trị thường gặp `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 video được tạo sau khi tác vụ thành công. cover_url: type: string description: URL bìa sau khi tác vụ thành công. watermarked_url: type: string description: URL video có watermark. security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer description: |- Sử dụng xác thực Bearer Token. Định dạng: `Authorization: Bearer sk-xxxxxx` ````