curl --request POST \
  --url https://api.aiid.edu.kg/ent/v2/img2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "viduq3-turbo",
  "prompt": "A cinematic product ad with smooth camera motion",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
'

{
  "task_id": "<string>",
  "state": "created",
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "duration": 123,
  "resolution": "<string>",
  "created_at": "<string>",
  "creations": "<string>"
}

Tạo video Vidu

Tạo video từ hình ảnh (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).

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.

viduq3-turbo, viduq2, vidu2.0 hỗ trợ tạo video từ văn bản, hình ảnh, khung hình đầu-cuối hoặc tham chiếu tùy theo khả năng của từng loại; cũng có thể tích hợp qua định dạng tương thích /v1/videos Sora.

Vidu Q4: vidu-q4 cố định ở 720p, vidu-q4-540p cố định ở 540p, hỗ trợ tạo video dài 3～16 giây. Yêu cầu ít nhất 1 ảnh và hỗ trợ tối đa 15 ảnh tham chiếu; quá trình tạo từ tham chiếu có thể kèm tối đa 3 đoạn âm thanh MP3, mỗi đoạn dài 3～12 giây và tối đa 50MB. Không hỗ trợ chỉ tạo từ văn bản, chỉ định khung hình đầu/cuối hoặc video tham chiếu. Nhiều ảnh được dùng làm tham chiếu chung, không biểu thị vị trí đầu/cuối. Có thể tạo tác vụ qua POST /v1/videos, POST /api/v3/contents/generations/tasks, hoặc theo định dạng Vidu POST /ent/v2/img2video, POST /ent/v2/reference2video. Khuyến nghị dùng mode=reference_images làm điểm vào hợp nhất; khi có âm thanh, dùng mode=reference_material. Có thể dùng audio_urls cho âm thanh tham chiếu; ở định dạng Seedance, cũng có thể dùng mục audio_url của content tiêu chuẩn; trường boolean audio biểu thị công tắc tạo âm thanh và được sử dụng riêng với danh sách URL âm thanh tham chiếu. Độ phân giải phải khớp với tên mô hình.

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, viduq2, vidu2.0, vidu-q4, vidu-q4-540p

Các trường yêu cầu thống nhất:

model (string, bắt buộc): Tên model công khai của Vidu. Vidu Q4 chỉ hỗ trợ tạo video từ hình ảnh và từ tham chiếu có kèm hình ảnh; Q3/Q2/V2 giữ nguyên các khả năng tương ứng.
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. Tạo video từ một hình ảnh dùng 1 ảnh; tạo từ tham chiếu của Vidu Q4 dùng 1–15 ảnh và các ảnh được dùng làm tham chiếu chung. Số lượng khung hình đầu-cuối và ảnh tham chiếu của các model cũ tùy thuộc vào khả năng tương ứng.
videos (array[string], tùy chọn): Chỉ cung cấp đầu vào chủ thể video theo khả năng của các model cũ; Vidu Q4 không hỗ trợ video tham chiếu.
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.
audio_urls (array[string], tùy chọn): Âm thanh tham chiếu cho Vidu Q4, tối đa 3 đoạn MP3, mỗi đoạn dài 3–12 giây và tối đa 50 MB; tách biệt với công tắc boolean audio.
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ợ các model viduq3-turbo, viduq2, vidu2.0; tạo video từ văn bản theo định dạng chính thức.
Vidu 图生视频: Hỗ trợ các model viduq3-turbo, viduq2, vidu2.0; tạo video từ một hình ảnh theo định dạng chính thức.
Vidu 首尾帧生视频: Hỗ trợ các model viduq3-turbo, viduq2, vidu2.0; tạo video từ hai hình ảnh khung hình đầu-cuối theo định dạng chính thức.
Vidu 参考生视频: Hỗ trợ các model viduq3-turbo, viduq2, vidu2.0; tạo video từ nhiều hình ảnh tham chiếu theo định dạng chính thức.
Vidu Q4 720p 单图: Hỗ trợ mô hình vidu-q4; ví dụ tham chiếu MP3 với một ảnh hoặc hai ảnh và hai đoạn MP3; nhiều ảnh dùng để tham chiếu chung, không chỉ định khung hình đầu và cuối. Thay URL tài nguyên mẫu trước khi gọi.
Vidu Q4 540p 单图: Hỗ trợ mô hình vidu-q4-540p; ví dụ tham chiếu MP3 với một ảnh hoặc hai ảnh và hai đoạn MP3; nhiều ảnh dùng để tham chiếu chung, không chỉ định khung hình đầu và cuối. Thay URL tài nguyên mẫu trước khi gọi.

POST

ent

img2video

curl --request POST \
  --url https://api.aiid.edu.kg/ent/v2/img2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "viduq3-turbo",
  "prompt": "A cinematic product ad with smooth camera motion",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
'

{
  "task_id": "<string>",
  "state": "created",
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "duration": 123,
  "resolution": "<string>",
  "created_at": "<string>",
  "creations": "<string>"
}

Ủy quyền

Authorization

string

header

bắt buộc

Sử dụng xác thực Bearer Token. Định dạng: Authorization: Bearer sk-xxxxxx

Nội dung

application/json

model

enum<string>

bắt buộc

Tên mô hình công khai của Vidu. Vidu Q4 chỉ hỗ trợ tạo video từ hình ảnh và tạo video tham chiếu có kèm hình ảnh; Q3/Q2/V2 giữ nguyên các khả năng tương ứng.

Tùy chọn có sẵn:

viduq3-turbo,

viduq2,

vidu2.0,

vidu-q4,

vidu-q4-540p

Ví dụ:

"viduq3-turbo"

images

string<uri>[]

bắt buộc

Đầu vào hình ảnh. Tạo ảnh từ một ảnh tạo ra 1 ảnh; Vidu Q4 tạo tham chiếu tạo ra 1–15 ảnh và các ảnh được dùng làm tham chiếu chung. Với các mô hình cũ, hãy sử dụng khung hình đầu/cuối và số lượng ảnh tham chiếu theo khả năng của từng mô hình.

Required array length: 1 element

Ví dụ:

["https://example.com/input.jpg"]

prompt

string

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

Ví dụ:

"A cinematic product ad with smooth camera motion"

videos

string<uri>[]

Chỉ cung cấp đầu vào chủ thể video theo khả năng của mô hình cũ; Vidu Q4 không hỗ trợ video tham chiếu.

subjects

object[]

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.

Hide child attributes

subjects.name

string

subjects.images

string<uri>[]

subjects.videos

string<uri>[]

subjects.voice_id

string

subjects.server_id

string

auto_subjects

boolean

duration

integer

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.

Ví dụ:

5

resolution

enum<string>

Độ phân giải đầu ra, các giá trị thường gặp là 540p, 720p, 1080p.

Tùy chọn có sẵn:

540p,

720p,

1080p

Ví dụ:

"720p"

aspect_ratio

enum<string>

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.

Tùy chọn có sẵn:

16:9,

9:16,

4:3,

3:4,

1:1

Ví dụ:

"16:9"

seed

integer

Hạt giống ngẫu nhiên.

movement_amplitude

enum<string>

Biên độ chuyển động, các giá trị thường gặp auto、small、medium、large。

Tùy chọn có sẵn:

auto,

small,

medium,

large

Ví dụ:

"auto"

audio

boolean

Có bật xuất trực tiếp âm thanh và video hay không.

audio_urls

string<uri>[]

Vidu Âm thanh tham chiếu Q4, tối đa 3 đoạn MP3, mỗi đoạn từ 3–12 giây, tối đa 50MB; tách biệt với công tắc Boolean audio.

Maximum array length: 3

audio_type

enum<string>

Tùy chọn có sẵn:

all,

speech_only,

sound_effect_only

voice_id

string

is_rec

boolean

bgm

boolean

payload

string

off_peak

boolean

Có sử dụng tạo lệch thời gian không.

watermark

boolean

Có thêm hình mờ hay không.

wm_position

enum<integer>

Tùy chọn có sẵn:

1,

2,

3,

4

wm_url

string<uri>

callback_url

string<uri>

Phản hồi

200 - application/json

Tạo nhiệm vụ thành công

task_id

string

bắt buộc

ID tác vụ được trả về khi tạo tác vụ, dùng để truy vấn tác vụ.

state

enum<string>

bắt buộc

Trạng thái tác vụ, các giá trị thường gặp created、queueing、processing、success、failed.

Tùy chọn có sẵn:

created,

queueing,

processing,

success,

failed

model

string

prompt

string

images

string[]

duration

integer

resolution

string

created_at

string

creations

string

Tổng quan

Lấy danh sách mô hình

Tạo hình ảnhOpenAI định dạng DALL-E

Tạo video HappyHorse và Wan

Tạo video Seedance

Tạo video Vidu

Định dạng Gemini cho tạo ảnh

Định dạng OpenAI (Chat)

Định dạng OpenAI (Responses)

Định dạng Video Generation Omni và Veo

Định dạng tác vụ tạo nhạc

Định dạng tương thích Sora cho tạo video

Định dạngKling tạo video

Tạo video từ hình ảnh (Vidu)

Ủy quyền

Nội dung

Phản hồi