Tạo video

Gửi yêu cầu bằng cấu trúc JSON thống nhất và nhận ID tác vụ; tham số riêng của mô hình được truyền qua các trường chung hoặc metadata.

POST/v1/video/generations

Tạo tác vụ tạo video bất đồng bộ từ prompt văn bản và hình ảnh tùy chọn. API trả về task_id để truy vấn trạng thái và kết quả của tác vụ sau đó.

Dạng đầu vào và tham số mở rộng của nhà cung cấp có thể khác nhau giữa các mô hình. Hãy chọn mô hình hỗ trợ tạo video và khả dụng với API Key hiện tại, đồng thời chỉ truyền các tham số mà mô hình đó hỗ trợ.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Gửi mô hình, prompt và các tham số tạo video tùy chọn bằng JSON.

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model*string

ID mô hình video cần sử dụng. Hãy chọn mô hình hỗ trợ tạo video và khả dụng với API Key hiện tại.

Độ dài1 <= length

prompt*string

Mô tả nội dung video muốn tạo. Nên nêu rõ chủ thể, hành động, bối cảnh, góc quay và phong cách.

Độ dài1 <= length

duration?number

Thời lượng video, tính bằng giây. Phạm vi giá trị tùy thuộc vào mô hình đã chọn.

fps?integer

Tốc độ khung hình của video đầu ra. Khả năng hỗ trợ và phạm vi giá trị tùy thuộc vào mô hình đã chọn.

height?integer

Chiều cao video đầu ra. Có thể dùng cùng width; khả năng hỗ trợ tùy thuộc vào mô hình đã chọn.

width?integer

Chiều rộng video đầu ra. Có thể dùng cùng height; khả năng hỗ trợ tùy thuộc vào mô hình đã chọn.

size?string

Kích thước video đầu ra, thường dùng định dạng chiều rộngxchiều cao; kích thước khả dụng tùy thuộc vào mô hình đã chọn.

image?string

Hình ảnh đầu vào để tạo video từ hình ảnh, có thể là URL hình ảnh hoặc dữ liệu Base64; dạng đầu vào cụ thể tùy thuộc vào mô hình đã chọn.

metadata?

Tham số mở rộng riêng của nhà cung cấp hoặc mô hình, như negative_prompt, style, quality_level, khung hình đầu/cuối và URL callback. Các trường này không có nghĩa là mọi mô hình video đều hỗ trợ chúng.

n?integer

Số video muốn tạo. Khả năng hỗ trợ và phạm vi giá trị tùy thuộc vào mô hình đã chọn.

response_format?string

Định dạng phản hồi mong muốn. Các giá trị khả dụng tùy thuộc vào mô hình và kênh đã chọn.

seed?integer

Seed dùng để kiểm soát tính ngẫu nhiên khi tạo video. Khả năng hỗ trợ tùy thuộc vào mô hình đã chọn.

user?string

Định danh người dùng cuối do bên gọi cung cấp.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Một phi hành gia mặc bộ đồ du hành vũ trụ đang đi trên Mặt Trăng, chất lượng cao, phong cách điện ảnh",    "size": "1920x1080",    "image": "https://example.com/input.jpg",    "duration": 5,    "metadata": {      "seed": 20231234,      "negative_prompt": "Mờ",      "image_tail": "https://example.com/end-frame.png"    }  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

201application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`