Tạo tác vụ tạo video
post/v1/video/generations
Gửi một tác vụ tạo video. Hỗ trợ cả text-to-video và image-to-video.
Trả về ID tác vụ để bạn có thể thăm dò trạng thái qua endpoint GET.
Xác thực
Gửi khóa API OLETOKEN dưới dạng token Bearer. Khóa được tạo tại trang API Keys trong bảng điều khiển.
Authorization: Bearer $OLETOKEN_API_KEYNội dung yêu cầu
Content-Type:application/json
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| model | string | — | ID mô hình hoặc kiểu |
| prompt | string | — | Prompt văn bản |
| image | string | — | Đầu vào hình ảnh (URL hoặc Base64) |
| duration | number | — | Thời lượng video tính bằng giây |
| width | integer | — | Chiều rộng video |
| height | integer | — | Chiều cao video |
| fps | integer | — | Tốc độ khung hình của video |
| seed | integer | — | Seed ngẫu nhiên |
| n | integer | — | Số lượng video cần tạo |
| response_format | string | — | Định dạng phản hồi |
| user | string | — | Mã định danh người dùng |
| metadata | object | — | Tham số bổ sung (như negative_prompt, style, quality_level) |
Phản hồi
200Đã tạo tác vụ tạo video
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| task_id | string | — | ID tác vụ |
| status | string | — | Trạng thái tác vụ |
400Tham số yêu cầu không hợp lệ
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| error | object | — | — |
| message | string | — | Thông báo lỗi |
| type | string | — | Loại lỗi |
| param | string | null | — | Tham số liên quan |
| code | string | null | — | Mã lỗi |
Ví dụ yêu cầu
curl -X POST 'https://api.oletoken.ai/v1/video/generations' \
-H "Authorization: Bearer $OLETOKEN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-v1",
"prompt": "宇航员在月球上漫步",
"duration": 5,
"width": 1280,
"height": 720
}'
