Skip to navigation
CompletionsVideos

Tạo video

Gửi request tạo video (bất đồng bộ). Trả về job ID để poll trạng thái.

Authentication

AuthorizationBearer

API key làm bearer token. Tạo API key tại Console.

Request

This endpoint expects an object.
modelstringRequired

Model ID. Chọn model có mode: video_generation (ví dụ: veo-3.1, seedance-2.0-mini)

promptstringRequired

Text mô tả video (tối đa 10.000 ký tự)

secondsintegerOptional

Thời lượng video (giây). Phải nằm trong allowedDurations của model

sizestringOptional

Kích thước / tỷ lệ khung hình (ví dụ: 1280x720, 16:9)

input_referencestring or objectOptional

Ảnh first frame cho image-to-video

last_framestring or objectOptional

Ảnh last frame (chỉ model Seedance). Phải gửi kèm input_reference

reference_imageslist of stringsOptional

Danh sách URL hoặc data URI ảnh tham khảo (tối đa 9, chỉ model Seedance)

resolutionstringOptional

Độ phân giải (ví dụ: 480p, 720p, 1080p, 4k). Chỉ model Seedance

seedintegerOptional

Seed để tạo kết quả có thể tái tạo

generate_audiobooleanOptional

Tạo âm thanh đồng bộ

watermarkbooleanOptional

Đóng dấu AI-generated vào video (chỉ model Seedance)

return_last_framebooleanOptional

Trả URL ảnh frame cuối khi hoàn tất (chỉ model Seedance)

parametersobjectOptional

Tham số pass-through đến provider

Response

Job đã tạo

idstringOptionalformat: "uuid"
objectstringOptional
statusenumOptional
  • submitted: Job đã được gửi và đang trong hàng đợi
  • processing: Video đang được tạo
  • completed: Video đã sẵn sàng để tải
  • failed: Quá trình tạo thất bại
  • expired: Job đã hết hạn trước khi hoàn tất
Allowed values:
modelstringOptional
created_atintegerOptional
completed_atintegerOptional
resultobjectOptional
usageobjectOptional
errorobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error