
Kling Image 4.0 API mang mô hình ảnh mới nhất của Kling AI đến lập trình viên qua một endpoint duy nhất của PoYo: gọi kling-4.0-image cho text-to-image, chỉnh sửa và bộ ảnh ở 2K, 4K hoặc 8K, và kling-4.0-long-image cho thiết kế trang web hoàn chỉnh hoặc trang ecommerce. Bài viết này giải thích Kling Image 4.0 là gì, từng trường request dùng để làm gì, các giới hạn và chi phí của một lần gọi trên PoYo.
Kling Image 4.0 là gì?
Kling Image 4.0 là mô hình ảnh thuộc dòng Kling 4.0 của Kling AI, nền tảng sáng tạo AI của Kuaishou. Mô hình được phát hành ngày 17 tháng 11 năm 2026. Trong bài viết ra mắt, Kling cho biết mô hình:
- tạo ảnh ở 8K gốc, tính năng Kling giới thiệu lần đầu với mô hình này;
- tạo tối đa 10 ảnh từ một prompt với phong cách và nội dung nhất quán;
- hiển thị tối đa 2,000 ký tự văn bản trong một ảnh, bằng tiếng Anh, tiếng Trung giản thể, tiếng Trung phồn thể, tiếng Nhật, tiếng Hàn, tiếng Tây Ban Nha và tiếng Bồ Đào Nha;
- tạo ảnh dạng dài cho trang chi tiết sản phẩm ecommerce và thiết kế web.
Kling cũng cho biết mô hình đã có trên Kling Creative Studio và cung cấp qua API cho doanh nghiệp và lập trình viên. PoYo đã thêm Kling Image 4.0 API vào tháng 11 năm 2026, không cần danh sách chờ và dùng cùng API key mà bạn dùng cho mọi mô hình khác trên PoYo.
Model ID của Kling Image 4.0 API trên PoYo
| Model ID | Dùng cho | Đầu ra |
|---|---|---|
kling-4.0-image | Text-to-image (không có image_urls), image-to-image với 1–10 ảnh tham chiếu, elements, bộ ảnh | 1–9 ảnh độc lập, hoặc một bộ 2–10 ảnh, ở 2K / 4K / 8K |
kling-4.0-long-image | Thiết kế trang skill: "webpage", trang chi tiết sản phẩm skill: "ecommerce" từ 1–3 ảnh sản phẩm | Một ảnh dọc dài, rộng 1024 px (1K) hoặc 2048 px (2K) |
Cả hai ID dùng chung endpoint submit, cùng cách polling task và cùng webhook callback_url. Slug của trang landing là kling-4-0-image; model ID trong request dùng dấu chấm (kling-4.0-image).
Endpoint và cấu trúc request
Mọi request Kling Image 4.0 API đều là task bất đồng bộ:
POST https://api.poyo.ai/api/generate/submitvớiAuthorization: Bearer $POYO_API_KEYvà body JSON gồmmodelcùnginput.- Đọc
data.task_idtừ phản hồi. - Polling
GET https://api.poyo.ai/api/generate/status/{task_id}cho đến khistatuslàfinishedhoặcfailed, hoặc truyềncallback_urlở cấp ngoài cùng để nhận một POST khi task kết thúc.
Một request 4K tối giản, lấy theo cấu trúc trong tài liệu:
{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
Task hoàn tất trả về ảnh trong data.files, mỗi ảnh có file_url và file_type: "image". Bộ ảnh được trả về theo đúng thứ tự. Hãy kiểm tra cả trường code trong body lẫn mã HTTP: PoYo có thể trả HTTP 200 với code: 400 khi có lỗi xác thực tham số. Phiên bản từng bước với cURL và Python có trong hướng dẫn Kling Image 4.0 API.
Các trường input và giới hạn
kling-4.0-image
| Trường | Giá trị | Ghi chú |
|---|---|---|
prompt | 1–50,000 ký tự | Bắt buộc. Tham chiếu input bằng @Image1, @Element1 |
image_urls | 1–10 URL | Chọn chế độ image-to-image. Mỗi ảnh tối đa 30 MB, mỗi cạnh tối thiểu 300 px, tỷ lệ khung hình 0.4–2.5 |
kling_elements | tối đa 7 element | Mỗi element là {"element_input_urls": [...]} với 2–4 góc nhìn, góc chính diện đặt đầu tiên. Cần có image_urls. Ảnh cộng element ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | Mặc định auto |
resolution | 2K, 4K, 8K | Mặc định 2K. 8K là 8192×8192 ở tỷ lệ 1:1 |
enable_sequential | true / false | true trả về một bộ ảnh nhất quán |
n | 1–9 (độc lập) hoặc 2–10 (bộ ảnh) | Mặc định lần lượt là 1 và 4 |
Schema từ chối các trường không xác định, vì vậy đừng gửi output_format, seed hay negative_prompt. Đầu ra là PNG.
kling-4.0-long-image
| Trường | Giá trị | Ghi chú |
|---|---|---|
skill | webpage (mặc định), ecommerce | Chọn loại trang |
image_urls | 1–3 ảnh sản phẩm | Bắt buộc với ecommerce |
style_image_url / subject_image_url | mỗi trường một URL | Chỉ dùng với webpage; @StyleImage, @SubjectImage |
length | short, medium (mặc định), long | Chỉ dùng với ecommerce: khoảng 2–5, 6–10 hoặc 11–18 phần |
resolution | 1K (mặc định), 2K | Chiều rộng 1024 hoặc 2048 px; chiều cao theo nội dung |
Mỗi request long image trả về một ảnh.
Giá Kling Image 4.0 API trên PoYo
PoYo tính phí theo mỗi ảnh được tạo (1 credit = $0.005). Credit chỉ bị trừ khi task thành công.
| Request | Credit | USD |
|---|---|---|
kling-4.0-image, 2K, mỗi ảnh | 13 | $0.065 |
kling-4.0-image, 4K, mỗi ảnh | 19 | $0.095 |
kling-4.0-image, 8K, mỗi ảnh | 32 | $0.16 |
Mỗi mục image_urls và mỗi element kling_elements, tính một lần cho mỗi request | 1 | $0.005 |
| Long image, webpage, 1K / 2K | 110 / 120 | $0.55 / $0.60 |
| Long image, ecommerce short, 1K / 2K | 47 / 57 | $0.235 / $0.285 |
| Long image, ecommerce medium, 1K / 2K | 94 / 110 | $0.47 / $0.55 |
| Long image, ecommerce long, 1K / 2K | 157 / 173 | $0.785 / $0.865 |
Long image, mỗi ảnh trong image_urls, style_image_url hoặc subject_image_url | 1 | $0.005 |
Bảng phân tích giá có các bảng giá long image và các ví dụ tính toán.
Kết quả đo được trong ngày ra mắt
Đội ngũ PoYo đã chạy các request sau trên API production vào ngày 19 tháng 11 năm 2026. Thời gian được tính từ lúc submit đến khi có kết quả, theo góc nhìn của client polling, nên chỉ mang tính tương đối.
| Request | Đầu ra | Chi phí | Thời gian |
|---|---|---|---|
kling-4.0-image, text-to-image, 16:9, 8K, n: 1 | PNG 10880×6144, khoảng 128 MB | 32 credit | khoảng 3.8 phút |
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4 | bốn ảnh 2720×1536, cùng người lái, xe đạp và trang phục từ bình minh đến đêm | 52 credit | khoảng 4.9 phút |
kling-4.0-long-image, skill: "webpage", 1K | một trang 1024×4257 | 110 credit | khoảng 1.7–2.2 phút |
Hai lưu ý tích hợp từ cùng lần chạy. File tải về là PNG có kênh alpha (RGBA) ngay cả với ảnh không trong suốt, vì vậy hãy chuyển đổi rõ ràng nếu pipeline của bạn cần RGB hoặc JPEG. Ngoài ra, một prompt webpage dài bằng tiếng Anh không nêu ngôn ngữ cho nội dung trang lại trả về chữ tiếng Trung; thêm câu "All text on the page is in English." đã khắc phục được. Chi tiết về cả hai có trong ảnh 8K và long image.
Những request nào nên gửi tới Kling Image 4.0 API?
- Ảnh in ấn, biển quảng cáo và công việc cần cắt ảnh nhiều đòi hỏi trên 4K: đây là mô hình ảnh duy nhất trên PoYo có mức
8K. - Storyboard, các góc sản phẩm và slide deck khi một nhân vật hoặc sản phẩm phải giữ nguyên qua các khung hình: dùng
enable_sequential. - Đặt một sản phẩm hoặc nhân vật có sẵn vào bối cảnh mới: truyền bối cảnh trong
image_urlsvà chủ thể dưới dạng element nhiều góc nhìn. - Mockup landing page và trang chi tiết ecommerce dưới dạng một ảnh:
kling-4.0-long-image.
Với bản nháp nhanh 1K–2K ở giá thấp nhất, Kling O3 Image rẻ hơn tính theo mỗi ảnh; xem Kling Image 4.0 API vs Kling O3 Image. Để cân nhắc so với các nhà cung cấp khác, đọc Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Câu hỏi thường gặp
Kling Image 4.0 API là gì?
Đây là quyền truy cập REST của PoYo tới mô hình Kling Image 4.0 của Kling AI, với model ID kling-4.0-image (ảnh tiêu chuẩn, chỉnh sửa và bộ ảnh) và kling-4.0-long-image (trang webpage và ecommerce dạng dài). Cả hai dùng POST /api/generate/submit và cùng một API key.
Kling Image 4.0 API có giá bao nhiêu? 13 credit ($0.065) mỗi ảnh ở 2K, 19 credit ($0.095) ở 4K và 32 credit ($0.16) ở 8K, cộng 1 credit ($0.005) cho mỗi ảnh tham chiếu hoặc element, tính một lần mỗi request. Long image có giá từ 47 đến 173 credit mỗi trang. Task thất bại không bị tính phí.
Kling Image 4.0 API có hỗ trợ image-to-image không?
Có. Truyền 1 đến 10 URL trong image_urls với kling-4.0-image và tham chiếu chúng trong prompt bằng @Image1, @Image2. Thêm tối đa 7 kling_elements để giữ nhân vật hoặc vật thể nhất quán; tổng số ảnh cộng element tối đa là 10.
Một request Kling Image 4.0 API mất bao lâu?
Trong thử nghiệm ngày ra mắt của chúng tôi, một ảnh 16:9 8K mất khoảng 3.8 phút, một bộ bốn ảnh 2K khoảng 4.9 phút và một webpage 1K khoảng 2 phút. Với các job lớn, hãy dùng callback_url thay vì giữ request mở.
Tài liệu Kling Image 4.0 API ở đâu? Tham chiếu các trường có trong tài liệu Kling Image 4.0 và tài liệu long image. Trang mô hình có playground hiển thị JSON tương ứng với cài đặt của bạn.