Kling: Video v3.0 Pro
Kling VIDEO 3.0 Pro là cấu hình video chuyên nghiệp 1080p của Kuaishou cho cảnh từ văn bản và ảnh. Cấu hình kết hợp đoạn từ ba đến mười lăm giây, âm thanh được tạo tích hợp, khung biên có hướng dẫn và chỉ đạo một hoặc nhiều cú máy cho ý tưởng điện ảnh và sản phẩm ngắn.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Kling VIDEO 3.0 Pro là cấu hình chuyên nghiệp của mô hình VIDEO 3.0 Kuaishou. Chế độ Pro được mô tả tạo video 1080p từ yêu cầu viết hoặc cảnh từ ảnh, với đoạn từ ba đến mười lăm giây. Phiên bản 3.0 kết hợp âm thanh được tạo tích hợp, điều khiển tính nhất quán chủ thể và chỉ đạo nhiều cú máy, cho sản phẩm ngắn cách rõ ràng để chỉ định diện mạo, hành động, góc máy và âm thanh.
Bắt đầu bằng hành động chính cảnh. Trong cú từ văn bản, mô tả chủ thể, môi trường, ánh sáng và góc nhìn làm hành động dễ đọc. Trong cú từ ảnh, để ảnh mở đầu xác lập diện mạo, bố cục rồi dùng văn bản cho thay đổi theo thời gian. Với ý tưởng sản phẩm ban đầu, ảnh chuẩn bị có thể cho vật trên bề mặt studio trong khi lời nhắc mô tả hé lộ chậm chất liệu và hình dạng.
Chỉ đạo nhiều cú cung cấp góc quay tự động hoặc chuỗi tùy chỉnh. Tạo nhiều cú tự động lên kế hoạch đổi bố cục và góc máy từ yêu cầu; cảnh vừa một góc liên tục vẫn có thể giữ một cú. Storyboard tùy chỉnh cho định nghĩa nội dung và thời lượng từng cú. Cấu hình cú tùy chỉnh cho phép một đến sáu cú, tối đa 512 ký tự mỗi cú và tối thiểu một giây mỗi cú; tổng thời lượng phải bằng toàn đoạn.
Với truyện ngắn, mô tả góc xác lập, hành động chính và chi tiết kết thúc thành cú riêng. Nêu cách máy quay và điều khán giả cần nhận thấy từng cú. Giữ diện mạo chủ thể lặp lại nhất quán trong yêu cầu, còn hành động và góc quay được đổi có chủ đích. Trường lời nhắc đơn trong tham chiếu nhà sản xuất nhận đến 2,500 ký tự; chuỗi tùy chỉnh dùng mô tả riêng từng cú.
Tham chiếu chủ thể có thể hỗ trợ cảnh từ ảnh khi nhân vật, sản phẩm hoặc bối cảnh cần còn dễ nhận ra. Chọn góc rõ truyền đạt đặc điểm cần giữ và gọi từng chủ thể tham chiếu nhất quán. Cấu hình từ ảnh được mô tả cho phép đến ba phần tử chuẩn bị. Giữ vai trò tham chiếu tập trung thay vì kết hợp nhiều tài sản đưa chỉ dẫn mâu thuẫn về diện mạo chủ thể.
Khung đầu và cuối cung cấp biên hình ảnh cho chuyển tiếp dựa trên ảnh. Chuẩn bị khung thống nhất chủ thể và cảnh dự kiến, rồi mô tả cách chuyển động nối chúng. Đầu vào khung được hỗ trợ dùng ảnh JPG, JPEG hoặc PNG, tệp không lớn hơn 10 MB, kích thước ít nhất 300 pixel và tỷ lệ ảnh đầu từ 1:2.5 đến 2.5:1. Tác vụ điều khiển bằng khung và storyboard tùy chỉnh có xử lý đầu vào riêng, nên tổ chức tư liệu cho quy trình đã chọn trước khi viết toàn yêu cầu.
Âm thanh được tạo tích hợp có thể kết hợp lời nói, không khí và diễn xuất hình ảnh. Âm thanh tắt mặc định trong tham chiếu nhà sản xuất và được bật cho cảnh có hình và tiếng. Cấu hình ngôn ngữ 3.0 gồm tiếng Trung, Anh, Nhật, Hàn và Tây Ban Nha, cùng chuyển đổi ngôn ngữ và cách thể hiện phương ngữ hoặc giọng vùng miền được hỗ trợ. Hướng dẫn nhà sản xuất cho biết hội thoại nhập bằng ngôn ngữ khác được dịch sang tiếng Anh. Gán từng câu cho chủ thể dự kiến và phân biệt hội thoại với âm nền để yêu cầu giải thích ai nói và điều gì bao quanh hành động.
Yêu cầu hai nhân vật ban đầu có thể xác định Speaker A và Speaker B, cho mỗi người câu ngắn và mô tả phản ứng nhìn thấy giữa họ. Giữ hội thoại tương xứng độ dài và xác định người nói khi đổi góc. Chỉ đạo giọng và tham chiếu nhân vật phục vụ mục đích khác; yêu cầu cần nêu diễn xuất dự kiến thay vì giả định ảnh tham chiếu chứa lời cần nói.
VIDEO 3.0 còn cải thiện xử lý chữ nhìn thấy trong cảnh từ ảnh. Nếu biển, nhãn hoặc chú thích quan trọng, xác định trong yêu cầu và giữ diện mạo tham chiếu. Xem đoạn hoàn tất về chính tả, khả năng đọc và chuyển động của chữ, đặc biệt khi mang thông điệp sản phẩm hoặc chiến dịch. Tính năng chữ của mô hình hướng dẫn tạo thay vì thay kiểm tra hình ảnh cuối.
Cấu hình Pro là 1080p; Standard là 720p. Chế độ 4K chọn riêng của nhà sản xuất là cấu hình đầu ra khác, nên không coi Pro đồng nghĩa mọi thiết lập độ phân giải cao hơn. Với tạo từ văn bản, lựa chọn bố cục được mô tả gồm 16:9, 9:16 và 1:1. Chọn khung cho vị trí dự kiến và giữ bố cục dễ đọc bên trong.
Tạo chạy như tác vụ có kết quả thành công cung cấp video hoàn tất và thời lượng thực tế. Tài liệu kết quả nhà sản xuất cho biết video được tạo bị xóa sau 30 ngày, nên lưu đoạn hoàn tất kịp thời. Giữ video cùng yêu cầu và tài sản tham chiếu, rồi xem xét tính liên tục chủ thể, thứ tự cú yêu cầu, chuyển động máy quay, hội thoại và chữ. Dùng đoạn đã chọn làm ý tưởng điện ảnh, cảnh sản phẩm hoặc truyện ngắn, sửa có trọng tâm phần không đạt kết quả dự kiến.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-v3.0-pro
kwaivgi/kling-v3.0-proBắt đầu
Kling VIDEO 3.0 Pro là cấu hình video chuyên nghiệp 1080p của Kuaishou cho cảnh từ văn bản và ảnh. Cấu hình kết hợp đoạn từ ba đến mười lăm giây, âm thanh được tạo tích hợp, khung biên có hướng dẫn và chỉ đạo một hoặc nhiều cú máy cho ý tưởng điện ảnh và sản phẩm ngắn.
- Đầu vào được chấp nhận
- Văn bản · Ảnh
- Kết quả
- Video
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Video POST /v1/videos
- Đầu vào
text,image- Đầu ra
video- Định dạng đầu ra
- byte MP4 gốc; không chuẩn hóa hoặc chuyển mã
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn kwaivgi/kling-v3.0-pro | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuBắt buộc | Giá trị & giới hạn 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Tối thiểu: 1 Tối đa: 600 | Mặc định— |
Trườngresolution | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 720p | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 16:9, 9:16, 1:1 | Mặc định— |
Trườnggenerate_audio | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false, true Điều kiện: Bỏ tùy chọn này sẽ chọn giá có âm thanh. Đặt false để chọn giá không có âm thanh. Kiểm tra has_audio trong kết quả để biết có bản âm thanh được trả về hay không. | Mặc định— |
Trườngframe_images | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối thiểu: 1 Số mục tối đa: 2 Nội dung đầu vào: Mảng đối tượng khung hình. Mỗi đối tượng có type=image_url, image_url chứa url và frame_type. Dùng URL ảnh HTTPS và đặt frame_type thành first_frame hoặc last_frame. Mỗi vai trò khung hình xuất hiện tối đa một lần. Khóa chính xác: type, image_url, frame_type Điều kiện: Các khóa này mô tả từng đối tượng khung hình; image_url chỉ chứa url. Bỏ frame_images đối với yêu cầu chỉ có văn bản. | Mặc định— |
Trườnginput_references | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngsize | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1280x720, 720x1280, 720x720 Mẫu: ^[1-9][0-9]*x[1-9][0-9]*$ | Mặc định— |
Trườngcallback_url | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Mẫu: ^https:// | Mặc định— |
Trườngsession_id | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngtrace | Loạiobject | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườnguser | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Tổ hợp tư liệu đầu vào
Văn bản thành video · Câu lệnh dạng văn bản. · Bắt buộc: model, prompt, duration
Cung cấp prompt dạng văn bản và duration là số giây nguyên. Chọn độ phân giải được hỗ trợ; thêm tỷ lệ khung hình hoặc dùng kích thước được liệt kê.
model: Loại: string · kwaivgi/kling-v3.0-pro
prompt: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có
Ảnh thành video · Câu lệnh dạng văn bản và ảnh khung hình đầu tiên. · Bắt buộc: model, prompt, duration, frame_images
frame_images là một mảng. Mỗi đối tượng khung hình có type, image_url và frame_type; image_url chứa url. Đặt type thành image_url. Dùng first_frame cùng last_frame tùy chọn. Mỗi vai trò khung hình xuất hiện tối đa một lần. Cung cấp URL ảnh HTTPS công khai cho mỗi khung hình. Chọn độ phân giải được hỗ trợ; thêm tỷ lệ khung hình hoặc dùng kích thước được liệt kê.
Khóa chính xác: type, image_url, frame_type
model: Loại: string · kwaivgi/kling-v3.0-pro
prompt: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, prompt, duration |
Tham sốmaterial_types | Hợp đồngtext, image |
Tham sốadditional_properties | Hợp đồngfalse |
Tham sốoptional_controls | Hợp đồngresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Vòng đời: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Bảng giá
Cách tính phí cuối cùng
Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí ước tính để so sánh
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Số lượng dự báo | Thành phần phí | Độ phân giải tham chiếu | Chế độ tham chiếu | Âm thanh tham chiếu | Đơn vị tính phí | Điều kiện tính phí | Phí |
|---|---|---|---|---|---|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Thành phần phí— | Độ phân giải tham chiếu— | Chế độ tham chiếu— | Âm thanh tham chiếu— | Đơn vị tính phí— | Điều kiện tính phí— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token |
| Cấu hìnhVideo đầu ra · đơn giá tham chiếu | Biểu mức phí— | Số lượng dự báo— | Thành phần phíreference_output_rate | Độ phân giải tham chiếu— | Chế độ tham chiếu— | Âm thanh tham chiếu— | Đơn vị tính phímỗi giây đầu ra | Điều kiện tính phí— | Phí Đầu ra · Đơn giá tham chiếu cho mỗi giây video đầu ra · Ước tính chỉ để so sánh $0.224 mỗi giây đầu ra |
| Cấu hìnhGiá video | Biểu mức phí— | Số lượng dự báo— | Thành phần phí— | Độ phân giải tham chiếu— | Chế độ tham chiếu— | Âm thanh tham chiếu— | Đơn vị tính phímỗi giây video | Điều kiện tính phíâm thanh: with_audio | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.336 mỗi giây video |
| Cấu hìnhTạo video từ ảnh (ảnh khung hình) · 1080p · đơn giá tham chiếu | Biểu mức phí— | Số lượng dự báo— | Thành phần phíreference_output_rate | Độ phân giải tham chiếu1080p | Chế độ tham chiếuẢnh thành video (ảnh khung hình) | Âm thanh tham chiếuKhông có âm thanh | Đơn vị tính phímỗi giây đầu ra | Điều kiện tính phí— | Phí Đầu ra · Đơn giá tham chiếu cho mỗi giây video đầu ra · Ước tính chỉ để so sánh $0.224 mỗi giây đầu ra |
| Cấu hìnhGiá video | Biểu mức phí— | Số lượng dự báo— | Thành phần phí— | Độ phân giải tham chiếu— | Chế độ tham chiếu— | Âm thanh tham chiếu— | Đơn vị tính phímỗi giây video | Điều kiện tính phíchế độ tạo: image_to_video; độ phân giải: 720p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.224 mỗi giây video |
| Cấu hìnhTạo video từ văn bản · 1080p · đơn giá tham chiếu | Biểu mức phí— | Số lượng dự báo— | Thành phần phíreference_output_rate | Độ phân giải tham chiếu1080p | Chế độ tham chiếuVăn bản thành video | Âm thanh tham chiếuKhông có âm thanh | Đơn vị tính phímỗi giây đầu ra | Điều kiện tính phí— | Phí Đầu ra · Đơn giá tham chiếu cho mỗi giây video đầu ra · Ước tính chỉ để so sánh $0.224 mỗi giây đầu ra |
| Cấu hìnhTạo video từ văn bản · 480p · đơn giá tham chiếu | Biểu mức phí— | Số lượng dự báo— | Thành phần phíreference_output_rate | Độ phân giải tham chiếu480p | Chế độ tham chiếuVăn bản thành video | Âm thanh tham chiếuKhông có âm thanh | Đơn vị tính phímỗi giây đầu ra | Điều kiện tính phí— | Phí Đầu ra · Đơn giá tham chiếu cho mỗi giây video đầu ra · Ước tính chỉ để so sánh $0.224 mỗi giây đầu ra |
| Cấu hìnhGiá video | Biểu mức phí— | Số lượng dự báo— | Thành phần phí— | Độ phân giải tham chiếu— | Chế độ tham chiếu— | Âm thanh tham chiếu— | Đơn vị tính phímỗi giây video | Điều kiện tính phíchế độ tạo: text_to_video; độ phân giải: 720p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh $0.224 mỗi giây video |
| Cấu hìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Thành phần phí— | Độ phân giải tham chiếu— | Chế độ tham chiếu— | Âm thanh tham chiếu— | Đơn vị tính phí— | Điều kiện tính phí— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.672 ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Chi tiết giá cước tham chiếu
Biểu tham chiếu cấp mô hình không thay đổi việc chọn phương thức, báo giá hoặc khoản phí. Khoản phí đang áp dụng dùng mức phí phương thức Ailoot đã chọn.
Tham chiếu giá theo cấu hình video
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhGiá video | Điều kiện tính phíKhông có điều kiện bổ sung nào được khai báo trong khóa định giá này. | Phí Đầu ra · Giá video $0.224 mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
| Cấu hìnhGiá video | Điều kiện tính phíâm thanh: with_audio | Phí Đầu ra · Giá video $0.336 mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
| Cấu hìnhGiá video | Điều kiện tính phíchế độ tạo: text_to_video; độ phân giải: 480p | Phí Đầu ra · Giá video $0.224 mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
| Cấu hìnhGiá video | Điều kiện tính phíchế độ tạo: text_to_video; độ phân giải: 720p | Phí Đầu ra · Giá video $0.224 mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
| Cấu hìnhGiá video | Điều kiện tính phíchế độ tạo: image_to_video; độ phân giải: 720p | Phí Đầu ra · Giá video $0.224 mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
| Cấu hìnhGiá video | Điều kiện tính phíchế độ tạo: text_to_video; độ phân giải: 1080p | Phí Đầu ra · Giá video $0.224 mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
| Cấu hìnhGiá video | Điều kiện tính phíchế độ tạo: image_to_video; độ phân giải: 1080p | Phí Đầu ra · Giá video $0.224 mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
Ví dụ yêu cầu
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Nhận và lưu kết quả
Ailoot Ultra · Video
các URL nội dung đã ký thuộc quyền sở hữu
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kiểm tra trạng thái tác vụ
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Lượt đọc nội dung khác
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Lưu tất cả kết quả đã hoàn tất
Lưu mọi video đã hoàn tất hoặc tệp trả về; truy xuất từng URL tài nguyên thực tế được trả về.
Giữ lại mọi đầu ra thực tế thuộc quyền sở hữu và siêu dữ liệu đo lường được trả về.
Nếu cần kiểm tra phản hồi gốc
503 result_pending_check + id ban đầu + X-Should-Retry:false; tuyệt đối không gửi lại yêu cầu ban đầu
Trường phản hồi
| Trường | Loại | Ý nghĩa |
|---|---|---|
Trườngindex | Loạiinteger | Ý nghĩaVị trí bắt đầu từ không của video này trong danh sách outputs. |
Trườngcontent_url | Loạistring | Ý nghĩaURL tải xuống HTTPS đã ký cho video đã hoàn tất này. |
Trườngsha256 | Loạistring | null | Ý nghĩaGiá trị băm SHA-256 của các byte video gốc; null nếu không có dữ liệu. |
Trườngsize_bytes | Loạiinteger | null | Ý nghĩaDung lượng tệp video gốc tính bằng byte; null nếu không có dữ liệu. |
Trườngduration_ms | Loạiinteger | null | Ý nghĩaThời lượng video đo được tính bằng mili giây; null nếu không có dữ liệu. |
Trườngwidth | Loạiinteger | null | Ý nghĩaChiều rộng video tính bằng pixel; null nếu không có dữ liệu. |
Trườngheight | Loạiinteger | null | Ý nghĩaChiều cao video tính bằng pixel; null nếu không có dữ liệu. |
Trườngvideo_codec | Loạistring | null | Ý nghĩaMã định danh codec video; null nếu chưa được ghi nhận. |
Trườnghas_audio | Loạiboolean | null | Ý nghĩaVideo có chứa bản âm thanh hay không; null nếu chưa được đo. |
Trườngaudio_codec | Loạistring | null | Ý nghĩaMã định danh codec âm thanh; null khi chưa ghi nhận mã định danh. |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi404 · not_found_error | Điều kiệnKhông thể truy cập video hoặc không tìm thấy ID video này. | Bước tiếp theoKiểm tra quyền truy cập video. Với video hiện có, dùng ID công khai ban đầu và cùng khóa API. |
Phản hồi401 · authentication_error | Điều kiệnKhóa API không khớp với tài khoản đã xác thực. | Bước tiếp theoKiểm tra khóa API và quyền truy cập tài khoản trước khi gửi. |
Phản hồi400 · invalid_request_error | Điều kiệnKhông thể đọc yêu cầu hoặc chỉ số tải xuống không hợp lệ. | Bước tiếp theoSửa nội dung yêu cầu. Để tải xuống, chọn một chỉ số đầu ra được tác vụ ban đầu trả về. |
Phản hồi422 · price_unavailable | Điều kiệnKhông thể định giá cấu hình video đã chọn. | Bước tiếp theoChọn cấu hình video được hỗ trợ và điền đầy đủ các tùy chọn bắt buộc trước khi gửi yêu cầu đã sửa. |
Phản hồi422 · invalid_request_error | Điều kiệnĐầu vào video hoặc tác vụ tiếp nối ban đầu không hợp lệ. | Bước tiếp theoDùng đầu vào HTTPS hợp lệ. Để tiếp nối, dùng ID video công khai ban đầu đã hoàn tất của bạn với cùng khóa API. |
Phản hồi402 · billing_error | Điều kiệnSố dư khả dụng hoặc các giới hạn không cho phép giữ trước số tiền. | Bước tiếp theoKiểm tra số dư khả dụng và các giới hạn trước khi gửi yêu cầu mới. |
Phản hồi503 · server_error | Điều kiệnTạm thời không thể xác minh video, lưu trữ hoặc truy cập dịch vụ. | Bước tiếp theoĐợi dịch vụ khả dụng. Nếu đã có ID video, kiểm tra tác vụ ban đầu đó thay vì tạo thêm video. |
Phản hồi503 · result_pending_check | Điều kiệnKết quả video và khoản phí ban đầu cần được kiểm tra. | Bước tiếp theoGiữ lại ID video được trả về và kiểm tra tác vụ đó. Không gửi yêu cầu tạo thay thế trong khi tác vụ đang được kiểm tra. |
Phản hồi503 · owned_result_unavailable | Điều kiệnTạm thời không thể tải xuống video hiện có. | Bước tiếp theoKiểm tra lại cùng tác vụ video sau và tải xuống đầu ra hiện có. Một lần tạo mới sẽ tạo thao tác riêng. |
Phản hồi409 · video_not_ready | Điều kiệnNội dung video chưa được công bố. | Bước tiếp theoKiểm tra trạng thái tác vụ ban đầu. Tải xuống sau khi trạng thái là completed; nếu là failed, làm theo thông báo kiểm tra khoản phí. |
Bí danh
Bí danh mô hình
Ailoot Ultra kwaivgi/kling-v3.0-pro
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · Kling: Video v3.0 Pro
- Có những đầu vào và kết quả nào?
POST /v1/videos·kwaivgi/kling-v3.0-pro:text,image→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·kwaivgi/kling-v3.0-pro:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Áp dụng những giới hạn nào?
POST /v1/videos·kwaivgi/kling-v3.0-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1