curl --request POST \
  --url https://api.aiid.edu.kg/ent/v2/start-end2video \
  --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>",
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "duration": 123,
  "resolution": "<string>",
  "credits": 123,
  "created_at": "<string>",
  "creations": "<string>"
}

Tạo video Vidu

Tạo video khung đầu và khung cuối (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.

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.

POST

ent

start-end2video

curl --request POST \
  --url https://api.aiid.edu.kg/ent/v2/start-end2video \
  --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>",
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "duration": 123,
  "resolution": "<string>",
  "credits": 123,
  "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

Vidu là tên mô hình công khai ra bên ngoài, hiện tại công khai viduq3-turbo.

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

viduq3-turbo

Ví dụ:

"viduq3-turbo"

images

string<uri>[]

bắt buộc

Đầ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.

Required array length: 2 elements

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>[]

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

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_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

credits

integer

Số điểm đã tiêu hao cho tác vụ này.

created_at

string

creations

string

Tạo video sinh tham chiếu(Vidu)Truy vấn tác vụ(Vidu)