Hướng dẫn Kling Image 4.0 Long Image
Tạo bố cục web và trang sản phẩm 2K với Kling Image 4.0 Long Image. Xem 2 lần chạy PNG thực tế, mẫu cURL, cách lấy kết quả và giá trực tiếp.
Đọc dạng MarkdownCác mô hình tạo ảnh thông thường chỉ sinh từng khung hình riêng lẻ. Khi cần làm một trang chi tiết sản phẩm hoặc trọn trang web ra mắt sản phẩm, bạn thường phải tạo sáu banner rời rạc rồi tự xoay xở trong phần mềm dàn trang với lề lệch nhau, phông chữ đổi liên tục và tỷ lệ sản phẩm thiếu đồng nhất. Kling Image 4.0 Long Image giải quyết bài toán theo cách khác: một yêu cầu API duy nhất trả về trọn một tệp PNG cuộn dọc liền mạch từ trên xuống dưới, cố định chiều rộng ở mức 1K (1024 px) hoặc 2K (2048 px) còn chiều cao tự mở rộng theo các mục trong đề bài.
Ngày 19 tháng 11 năm 2026, chúng tôi đã chạy hai tác vụ 2K qua endpoint /v1/images/generations của SeedRouter để kiểm chứng cả hai chế độ với đề bài sát thực tế sản xuất. Lần chạy đầu tiên dùng chế độ webpage chỉ với văn bản và trả về trang ra mắt sản phẩm cho một thương hiệu tai nghe phòng thu hư cấu với kích thước 2048 × 16385 px (17 MB, 169 giây). Lần chạy thứ hai dùng chế độ ecommerce ở độ dài medium kèm hai ảnh tham chiếu trang sức có sẵn và trả về trang chi tiết sản phẩm kích thước 2048 × 19533 px (25 MB, 261 giây). Bạn có thể xem trọn hai bản dàn trang bên dưới, thử trực tiếp cả hai đề bài trong Playground Kling Image 4.0 Long Image và kiểm tra chính xác giá từng bậc ở bảng giá trực tiếp phía cuối bài.
Chọn ecommerce hoặc webpage trước khi viết bất kỳ dòng mã nào
Trường settings.skill là bắt buộc và quyết định cả cấu trúc dàn trang lẫn tập tham số mà API chấp nhận. Hãy xem hai chế độ này như hai giao kèo riêng biệt chứ không phải hai bộ lọc phong cách thuần túy.
Dùng ecommerce khi bạn đã có ảnh chụp sản phẩm thật và cần một trang chi tiết sản phẩm (PDP) cuộn dọc cho website bán hàng hoặc sàn thương mại điện tử. Trong chế độ ecommerce, bạn bắt buộc phải truyền từ một đến ba mục refer_image trong contents, đồng thời kiểm soát độ dày các mục theo chiều dọc qua settings.length (short, medium hoặc long, mặc định là medium). Yêu cầu không có ảnh sản phẩm tham chiếu sẽ bị từ chối ngay trước khi tính phí.
Dùng webpage khi bạn thiết kế landing page thương hiệu, trang ra mắt sản phẩm hoặc bố cục web theo phong cách biên tập. Ở chế độ webpage, ảnh tham chiếu là tùy chọn: bạn có thể chạy thuần văn bản, hoặc truyền tối đa một style_refer_image để định hướng bảng màu cùng nhịp bố cục và tối đa một subject_refer_image để giữ vững chủ thể trọng tâm. Không gửi refer_image hay settings.length trong chế độ webpage; cả hai trường này chỉ dành riêng cho ecommerce và sẽ báo lỗi xác thực nếu trộn lẫn chế độ.
| Thiết lập hoặc đầu vào | Chế độ ecommerce | Chế độ webpage |
|---|---|---|
settings.skill | "ecommerce" (bắt buộc) | "webpage" (bắt buộc) |
settings.length | "short", "medium" (mặc định) hoặc "long" | Bỏ qua hoàn toàn |
settings.resolution | "1k" (rộng 1024 px) hoặc "2k" (rộng 2048 px) | "1k" (rộng 1024 px) hoặc "2k" (rộng 2048 px) |
Các mục refer_image | Bắt buộc: 1 đến 3 URL JPEG/PNG công khai | Không được phép |
style_refer_image / subject_refer_image | Không được phép | Tùy chọn: tối đa 1 ảnh mỗi loại |
Cả hai chế độ đều không nhận 4k, số lượng ảnh hàng loạt (n) hay tỷ lệ khung hình. Mỗi tác vụ thành công luôn trả về đúng một URL ảnh PNG dài tại output.data[0].url.
Lần chạy 1: Bố cục trang web 2K thuần văn bản (2048 × 16385)

Hình trên xếp song song bốn phần tư theo chiều dọc của lần chạy webpage 2K. Đề bài yêu cầu một trang ra mắt mang tinh thần thiết kế công nghiệp Thụy Sĩ trên nền đá obsidian tối cho mẫu tai nghe planar dạng mở tên S-01 Reference Planar: thanh điều hướng tối giản, ảnh mở đầu góc ba phần tư, dải ba cột nêu điểm mạnh về âm học, ảnh cắt lớp gia công CNC, bảng thông số kỹ thuật kèm số liệu điện học cụ thể và chân trang gọn gàng.
Hãy nhìn kỹ những gì giữ được độ liền mạch trong một lượt dựng duy nhất. Xuyên suốt 16.385 pixel chiều dọc, nền than tối, tiêu đề chữ có chân và hình khối nhôm phay của chiếc tai nghe vẫn đồng nhất từ thanh điều hướng trên cùng xuống tới dải năm phối màu và bảng thông số. Toàn bộ con số kỹ thuật yêu cầu đều hiển thị rõ ràng (106 mm Iso-Planar, 32 Ohms, 98 dB/mW, 8 Hz–52 kHz, 410 g). Có một chi tiết nhỏ rút ra khi soi tệp PNG ở mức phóng 100%: prompt yêu cầu dải nền trắng ngà phía sau bảng thông số, nhưng mô hình lại giữ bảng thông số trên nền đá sẫm và đặt dải xám sáng xuống phần đăng ký bản tin ngay bên dưới. Nếu việc đổi màu nền chính xác ở từng khối là điều kiện cứng khi bàn giao cho đội front-end, hãy xem ảnh đầu ra như bản định hướng mỹ thuật rồi cắt hoặc dựng lại khối HTML đó từ ảnh chụp đã sinh ra.
Viết đề bài hiệu quả cho chế độ webpage giống viết dàn ý wireframe hơn là viết prompt ảnh tĩnh. Đưa các quy chuẩn thiết kế toàn trang lên trước (mã màu nền, chất liệu bề mặt, màu nhấn, kỷ luật lưới), rồi đánh số từng khối từ trên xuống dưới kèm sẵn câu chữ cụ thể cho tiêu đề và thông số quan trọng. Để tiêu đề chung chung rất dễ khiến mô hình tự điền chữ giữ chỗ.
curl --fail-with-body -sS https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0-long-image",
"contents": [{
"type": "prompt",
"text": "Design a vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
}],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}' -o solstice-task.json
jq -er '.id' solstice-task.jsonLưu ý rằng payload trên bỏ qua hoàn toàn settings.length và contents chỉ chứa mục prompt. Bạn có thể xem đầy đủ đặc tả tham số tại tài liệu tham khảo API Kling Image 4.0 Long Image. [1]
Lần chạy 2: Trang chi tiết sản phẩm 2K dùng hai ảnh tham chiếu (2048 × 19533)

Sang lần chạy thứ hai, chúng tôi đổi settings.skill thành "ecommerce", đặt settings.length là "medium", giữ resolution ở "2k", rồi truyền vào hai ảnh trang sức sẵn có dưới dạng refer_image: một ảnh chụp cận chiếc khuyên tai dáng thả hình hoa lan vàng chạm khắc gắn id: "earring", và một ảnh chân dung thời trang trong nhà kính với người mẫu đeo đúng chiếc khuyên tai đó gắn id: "model".
Trong prompt, chúng tôi nhắc đến hai ảnh này bằng @earring và @model ngay trong mô tả từng mục. API sẽ tự động ánh xạ các ID có tên đó sang vị trí tham chiếu tương ứng, nên bạn không cần tự đếm chỉ số. Mỗi ảnh tham chiếu phải là URL JPEG hoặc PNG công khai dung lượng tối đa 30 MB, mỗi cạnh tối thiểu 300 px và tỷ lệ khung hình nằm trong khoảng 2:5 đến 5:2.

Một lệnh gọi 2K độ dài trung bình duy nhất đã tạo ra 19.533 pixel chiều dọc với trọn vẹn sáu khối thương mại điện tử: phần mở đầu trên nền lụa champagne, khối cảm hứng thiết kế giàu chất thơ, ảnh tách nền studio đi kèm bảng thông tin sản phẩm sáu dòng (Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box), ảnh chân dung On The Ear bám sát @model, lưới sáu góc chụp sản phẩm (Front, Side, Back, Core Detail, Hook Detail, Profile) và sơ đồ chú thích Craft And Beauty phóng cận ở hình trên.
Khi rà soát ở độ phân giải gốc, chúng tôi cũng phát hiện một lỗi đáng lưu ý trước khi đưa thẳng trang PDP sinh tự động lên gian hàng thật. Dù bảng thông số giữ nguyên tên mẫu Phalaenopsis No. 4 Drop Earring và mọi nhãn chú thích đều đúng chính tả, phần banner đầu trang lại rút gọn Botanical Series thành BOTA SERIES và BOTA — Drop Earring thay vì in đúng tên thương hiệu yêu cầu là L'ORCHIDÉE. Đây là dạng lỗi khá điển hình khi sinh chữ trên trang dài: nhãn ngắn và dòng thông số cực kỳ ổn định, còn tên thương hiệu viết hoa cách điệu ở phần mở đầu thỉnh thoảng bị lệch chữ. Luôn kiểm tra tiêu đề đầu trang ở kích thước thật, đồng thời giữ logo thương hiệu hoặc thông tin pháp lý bắt buộc dưới dạng lớp vector riêng trên giao diện gian hàng.
curl --fail-with-body -sS https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0-long-image",
"contents": [
{
"type": "prompt",
"text": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
},
{
"type": "refer_image",
"id": "earring",
"url": "https://example.com/assets/gold-orchid-earring.png"
},
{
"type": "refer_image",
"id": "model",
"url": "https://example.com/assets/editorial-portrait.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}' -o orchidee-task.json
jq -er '.id' orchidee-task.jsonNếu dùng ảnh tham chiếu trong chế độ webpage, hãy nhớ quy tắc đặt tên sau: dùng style_refer_image cho hướng thẩm mỹ và subject_refer_image cho sản phẩm trung tâm, gán cho mỗi ảnh một id chữ-số riêng biệt (1 đến 32 ký tự, không dấu cách) rồi gọi bằng @id trong prompt. Tuyệt đối không đặt trùng ID trong cùng mảng contents.
Kiên nhẫn kiểm tra trạng thái và dự trù cho tệp PNG 2K dung lượng lớn
Các trang cuộn dọc mất nhiều thời gian xử lý hơn hẳn ảnh đơn thông thường và trả về tệp nặng hơn nhiều. Coi chúng như một API tạo ảnh thu nhỏ mất năm giây là cách nhanh nhất dẫn đến lỗi hết thời gian chờ hoặc gửi trùng gây tính phí hai lần.
Trong hai lần chạy ngày 19 tháng 11, trang web 2048 × 16385 hoàn tất sau 169 giây (17 MB), còn trang ecommerce độ dài trung bình 2048 × 19533 hoàn tất sau 261 giây (25 MB). Các trang ecommerce 2K độ dài long có thể chạy quá bảy phút và vượt mức 50 MB. Hãy lưu lại ID tác vụ ngay khi POST /v1/images/generations trả về, kiểm tra GET /v1/tasks/{id} mỗi 15 đến 20 giây và không bao giờ gửi lại yêu cầu POST thứ hai chỉ vì phiên terminal bị ngắt hoặc client hết thời gian chờ. [2]
TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.jsonKhi status trả về completed, lấy URL tệp PNG duy nhất từ output.data[0].url và ghi thẳng xuống ổ đĩa với thời gian chờ truyền tải đủ rộng:
IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.pngTrong các worker phía backend, tránh nạp toàn bộ tệp PNG vào một vùng đệm bộ nhớ cố định nhỏ trước khi ghi ra đĩa hoặc lưu trữ đối tượng. Hãy stream trực tiếp phần thân phản hồi HTTP xuống tệp, kiểm tra kích thước ảnh trước khi cắt từng khối cho gian hàng di động và chuyển bản hiển thị sang WebP trong khi giữ bản PNG gốc để in ấn hoặc xuất lát cắt.
Hoạch định ngân sách cho tám bậc đầu ra và ảnh tham chiếu
Chi phí của Kling Image 4.0 Long Image phụ thuộc vào ba lựa chọn: skill (ecommerce hay webpage), length (short, medium hoặc long ở chế độ ecommerce) và resolution (1k hay 2k). Mỗi ảnh tham chiếu đầu vào (refer_image, style_refer_image hoặc subject_refer_image) tính thêm một lượt phí ảnh đầu vào ngay từ tấm đầu tiên, không có suất miễn phí.
Nhờ vậy, chiến lược chạy thử rất rõ ràng. Khi tinh chỉnh thứ tự các mục, nhịp tiêu đề và phân cấp màu sắc cho danh mục ecommerce, hãy thử trước ở 1k short hoặc medium, rà soát luồng cuộn dọc rồi mới chuyển sang 2k khi đề bài đã vào khuôn. Với bố cục webpage, chênh lệch giữa 1k và 2k đủ nhỏ để chọn thẳng 2k ngay khi bạn cần các bảng thông số chữ nhỏ sắc nét. Lần chạy đầu tiên của chúng tôi chốt đúng theo mức giá webpage 2K; lần chạy thứ hai chốt theo mức ecommerce medium 2K cộng hai phí ảnh đầu vào. Yêu cầu thất bại không bị tính phí. Xem bảng giá cập nhật bên dưới hoặc nhập đúng cấu hình vào công cụ tính giá Kling Image 4.0 Long Image. [3]
Chi phí dùng Kling Image 4.0 Long Image
| Danh mục | Giá (USD) |
|---|---|
| Ecommerce · 1K · short | 0,2269 US$ |
| Ecommerce · 2K · short | 0,2723 US$ |
| Ecommerce · 1K · medium | 0,4538 US$ |
| Ecommerce · 2K · medium | 0,5294 US$ |
| Ecommerce · 1K · long | 0,7563 US$ |
| Ecommerce · 2K · long | 0,8319 US$ |
| Webpage · 1K | 0,5294 US$ |
| Webpage · 2K | 0,5748 US$ |
| Ảnh tham chiếu | 0,003025 US$ |
Câu hỏi thường gặp
Làm sao chọn giữa short, medium và long trong chế độ ecommerce?
Hãy đếm số khối nội dung thực sự cần thiết cho sản phẩm trước khi chọn length. Trang short phù hợp cho ba đến bốn khối cô đọng như ảnh mở đầu, lợi ích chính và khung thông số gọn. Trang medium chứa thoải mái khoảng sáu mục như ví dụ trang sức ở trên (ảnh mở đầu, câu chuyện thiết kế, ảnh tách nền studio, bảng thông số, ảnh đeo thực tế, lưới nhiều góc và sơ đồ chú thích). Dành long cho thiết bị kỹ thuật hoặc danh mục nhiều phiên bản cần thêm bảng so sánh, hướng dẫn sử dụng từng bước và chi tiết đóng gói mà không làm chữ bị chật chội.
Vì sao yêu cầu webpage của tôi trả về lỗi HTTP 400?
Hai lỗi xác thực phổ biến nhất là gửi kèm settings.length khi skill: "webpage" và gắn nhãn ảnh tham chiếu là type: "refer_image" thay vì style_refer_image hoặc subject_refer_image. Cả hai trường đó chỉ dùng riêng cho chế độ ecommerce. Ngoài ra, hãy kiểm tra xem prompt có vượt giới hạn ký tự có trọng số (en / 166000 + non_en / 71000 <= 1, tính sau khi đã ánh xạ các vị trí @id) hay không và chắc chắn resolution là "1k" hoặc "2k".
Tôi có nên cắt nhỏ tệp PNG hoàn chỉnh trước khi đưa lên gian hàng trực tuyến không?
Có. Một tệp PNG 2048 × 19533 chưa nén nặng khoảng 17 đến 25 MB, quá lớn để nhúng nguyên khối trong một thẻ <img> trên mạng di động. Hãy cắt trang hoàn chỉnh theo ranh giới ngang giữa các khối, nén từng phần sang WebP hoặc AVIF để tải dần nhanh hơn và thay các dấu hiệu pháp lý quan trọng, giá bán hay nút mua hàng bằng văn bản HTML thật. Bạn có thể thử prompt và xem ảnh nguyên chiều cao ngay trong Playground Kling Image 4.0 Long Image trước khi tự động hóa quy trình.



