curl --request POST \
--url https://api.aiid.edu.kg/omni-video/kling-4.0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"settings": {
"resolution": "720p",
"duration": 10,
"aspect_ratio": "16:9"
},
"options": {},
"contents": [
{
"type": "prompt",
"text": "A cinematic product shot with natural motion"
},
{
"type": "refer_image",
"url": "https://example.com/reference.jpg"
},
{
"type": "feature_video",
"url": "https://example.com/motion.mp4"
}
]
}
'{
"code": 0,
"message": "SUCCEED",
"request_id": "request_example",
"data": {
"id": "task_example",
"status": "submitted",
"create_time": 1792710000000,
"update_time": 1792710000000,
"external_id": ""
}
}Kling Tham khảo toàn diện
Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết Định dạng tương thích với Sora tạo video).
Giao diện tác vụ gốc Kling 4.0. Sử dụng Bearer API Key của trang này để xác thực. Nội dung yêu cầu không cần model; settings.resolution=720p sử dụng kling-4.0, 1080p sử dụng kling-4.0-1080p, mặc định là 1080p. Sau khi tạo thành công, dùng data.id trả về để gọi GET /tasks?task_ids=ID tác vụ; nhiều ID được phân tách bằng dấu phẩy. data của kết quả truy vấn là một mảng, URL video kết quả nằm tại data[].outputs[].url.
Hiện hỗ trợ các trường hợp tạo tương ứng với prompt, first_frame, last_frame, refer_image và feature_video. Không hỗ trợ middle_frame, base_video, element, voice, tham chiếu âm thanh, callback hoặc ID tác vụ bên ngoài tùy chỉnh; options.callback_url không rỗng, options.external_task_id không rỗng, contents.id không rỗng và các trường không được hỗ trợ khác sẽ trả về 400. Có thể bỏ qua options hoặc truyền một đối tượng rỗng, hoặc truyền watermark_info.enabled=false; hiện chưa hỗ trợ bật hình mờ. Thời lượng hiện được hỗ trợ từ 4 đến 30 giây, mặc định là 10 giây; chưa hỗ trợ 3 giây. Tỷ lệ khung hình mặc định cho các trường hợp văn bản tạo sinh và tham chiếu là 16:9; việc chỉ định rõ adaptive sẽ trả về 400. Trường hợp khung hình đầu-cuối không chấp nhận settings.aspect_ratio được chỉ định rõ; tỷ lệ khung hình được xác định theo kích thước của ảnh frame đầu tiên.
contents cho tham chiếu đa năng phải bao gồm prompt không rỗng và ít nhất một nội dung đa phương tiện được hỗ trợ. Trong các trường hợp khung hình đầu/cuối trước đây, có thể truyền first_frame, last_frame hoặc cả hai, nhưng khả năng xử lý phụ thuộc vào các khả năng hiện có của mô hình; yêu cầu sẽ bị từ chối nếu khả năng không tương thích và hình khung sẽ không bị âm thầm chuyển thành hình tham chiếu thông thường. Đối với việc tích hợp mới khung hình đầu/cuối, bạn nên sử dụng điểm vào tạo video từ hình ảnh. Không thể dùng chung khung hình đầu/cuối với hình tham chiếu refer_image hoặc video tham chiếu feature_video; việc dùng chung sẽ trả về 400. Trong trường hợp tham chiếu, có thể kết hợp hình tham chiếu refer_image và video tham chiếu feature_video. Mỗi first_frame, last_frame và refer_image tối đa 1 mục; feature_video tối đa 5 mục. Hiện chưa hỗ trợ trường hợp nhiều hình tham chiếu dựa vào tham chiếu id.
curl --request POST \
--url https://api.aiid.edu.kg/omni-video/kling-4.0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"settings": {
"resolution": "720p",
"duration": 10,
"aspect_ratio": "16:9"
},
"options": {},
"contents": [
{
"type": "prompt",
"text": "A cinematic product shot with natural motion"
},
{
"type": "refer_image",
"url": "https://example.com/reference.jpg"
},
{
"type": "feature_video",
"url": "https://example.com/motion.mp4"
}
]
}
'{
"code": 0,
"message": "SUCCEED",
"request_id": "request_example",
"data": {
"id": "task_example",
"status": "submitted",
"create_time": 1792710000000,
"update_time": 1792710000000,
"external_id": ""
}
}Ủy quyền
Sử dụng xác thực Bearer Token.
Định dạng: Authorization: Bearer sk-xxxxxx
Nội dung
- Option 1
- Option 2
Các trường hợp tương thích khung hình đầu/cuối trước đây: first_frame, last_frame hoặc cả hai, tùy thuộc vào khả năng của các mô hình hiện có. Không dùng lẫn tài liệu tham chiếu; bỏ qua aspect_ratio, tỷ lệ khung hình theo frame đầu tiên.
Phải đồng thời bao gồm prompt không rỗng và nội dung đa phương tiện được hỗ trợ; tạo video từ ảnh phải bao gồm first_frame. Không thể dùng lẫn first_frame/last_frame với refer_image/feature_video, nếu không sẽ trả về 400. Giới hạn số lượng của từng loại nội dung đa phương tiện xem trong phần mô tả API. Các yêu cầu khung hình đầu-cuối trước đây được xác thực theo khả năng của mô hình hiện có; đối với tích hợp mới dùng khung hình đầu-cuối, bạn nên sử dụng điểm cuối tạo video từ ảnh.
2Phản hồi
Thành công
0
Hide child attributes
Hide child attributes
ID tác vụ của trang này, khi truy vấn hãy truyền nguyên văn.
submitted, processing, succeeded, failed Thời gian tạo, tính bằng mili giây Unix.
Thời gian cập nhật, tính bằng mili giây Unix.