Tạo video

Gửi các trường chung bằng cấu trúc yêu cầu thống nhất của nền tảng và truyền tham số riêng của Vidu trong metadata.

POST/v1/video/generations

Tạo tác vụ Vidu qua endpoint tác vụ video chung của nền tảng. Nền tảng ánh xạ các trường chung sang tính năng tạo video tương ứng của Vidu.

Các mô hình Vidu gồm viduq3-pro, viduq2, viduq1, vidu2.0 và vidu1.5. Ví dụ sử dụng MODEL_ID; mô hình khả dụng thực tế tùy thuộc vào danh sách mô hình mà API Key hiện tại trả về.

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

Yêu cầu tạo video Vidu theo định dạng nền tảng.

Định nghĩa kiểu TypeScript

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

model*string

ID mô hình video Vidu. Mô hình khả dụng thực tế tùy thuộc vào danh sách mô hình mà API Key hiện tại trả về.

Độ dài1 <= length

prompt*string

Mô tả nội dung video muốn tạo.

Độ dài1 <= length

images?array<string>

Danh sách URL hình ảnh tham chiếu. Có thể bỏ qua khi tạo video từ văn bản; thường truyền 1 hình ảnh khi tạo video từ hình ảnh, 2 hình ảnh khi dùng khung hình đầu/cuối và nhiều hình ảnh khi dùng chế độ hình ảnh tham chiếu.

image?string

URL một hình ảnh tham chiếu được một số máy khách tương thích sử dụng.

size?string

Độ phân giải đầu ra, ví dụ 720p hoặc 1080p, tương ứng với resolution của Vidu.

duration?integer

Thời lượng video, tính bằng giây.

Giá trị được phép

metadata?

Tham số mở rộng riêng của Vidu.

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 con ngựa phong cách cyberpunk đang chạy, phía sau là thành phố tương lai với ánh đèn neon nhấp nháy",    "size": "720p",    "duration": 5  }'

{
  "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`