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](https://console.staging.tram.ai.vn/keys).

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

idstringformat: "uuid"
objectstring
statusenum
  • 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
modelstring
created_atinteger
completed_atinteger
resultobject
usageobject
errorobject

Errors

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