Claude Opus 5.5 đã có trên SeedRouter

Image

Kling Image 4.0 Long Image

View Markdown

Tạo trang chi tiết sản phẩm và thiết kế web dài 1K hoặc 2K với Kling Image 4.0 Long Image, sau đó kiểm tra trạng thái để lấy URL ảnh PNG hoàn chỉnh.

Gửi yêu cầu JSON đến POST /v1/images/generations với ID mô hình kling-image-4-0-long-image. Lưu ID tác vụ được trả về, sau đó kiểm tra trạng thái qua GET /v1/tasks/{id} cho đến khi tệp PNG dài hoàn tất.

Ví dụ nhanh

Yêu cầu này tạo một bố cục trang web 1K từ mô tả văn bản. Lưu khóa API trong biến môi trường SEEDROUTER_API_KEY.

curl 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 tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
    ],
    "settings": {"skill": "webpage", "resolution": "1k"}
  }'

Endpoint và header

Gửi JSON đến POST https://api.seedrouter.ai/v1/images/generations kèm Content-Type: application/json và Authorization: Bearer YOUR_API_KEY. Luôn giữ khóa API ở phía máy chủ.

Tham số

TrườngKiểuGiá trị và mặc định
modelstring, bắt buộckling-image-4-0-long-image
contentsarray, bắt buộcMột mục prompt cùng các mục ảnh tham chiếu tùy theo chế độ.
contents[].typestring, bắt buộcprompt, refer_image (chỉ dùng cho ecommerce, bắt buộc 1–3 ảnh), style_refer_image (chỉ dùng cho webpage, tối đa 1 ảnh) hoặc subject_refer_image (chỉ dùng cho webpage, tối đa 1 ảnh). Không hỗ trợ element.
contents[].textstringBắt buộc với prompt. Giới hạn chỉ tiếng Anh là 166.000 ký tự, không phải tiếng Anh là 71.000 ký tự. Văn bản pha trộn phải thỏa english / 166000 + non_english / 71000 <= 1.
contents[].urlstringBắt buộc với mỗi mục ảnh. URL HTTP(S) công khai của tệp JPEG hoặc PNG tối đa 30 MB, mỗi cạnh tối thiểu 300 px, tỷ lệ khung hình từ 2:5 đến 5:2.
contents[].idstringID tham chiếu duy nhất tùy chọn trong toàn bộ các mục ảnh của yêu cầu. Nhắc lại trong mô tả bằng cú pháp @id.
settings.skillstring, bắt buộcecommerce cho trang chi tiết sản phẩm hoặc webpage cho thiết kế trang web.
settings.lengthstringshort (~2–5 mục), medium (mặc định, ~6–10 mục) hoặc long (~11–18 mục). Chỉ áp dụng cho ecommerce; bị bỏ qua khi dùng webpage.
settings.resolutionstring1k (mặc định, rộng 1024 px) hoặc 2k (rộng 2048 px). Chiều cao tự co giãn theo nội dung. Không hỗ trợ 4k.
options.watermark_info.enabledbooleanTùy chọn. Chỉ hỗ trợ giá trị false.

Trang chi tiết sản phẩm ecommerce

Chế độ ecommerce yêu cầu từ 1 đến 3 mục refer_image. Gọi từng ảnh bằng id tương ứng trong mô tả.

{
  "model": "kling-image-4-0-long-image",
  "contents": [
    {"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
    {"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
    {"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
  ],
  "settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}

Thiết kế trang web kèm ảnh tham chiếu phong cách và chủ thể

Chế độ webpage chấp nhận các mục tùy chọn style_refer_image (tối đa 1) và subject_refer_image (tối đa 1). Bỏ qua settings.length khi dùng chế độ webpage.

{
  "model": "kling-image-4-0-long-image",
  "contents": [
    {"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
    {"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
    {"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
  ],
  "settings": {"skill": "webpage", "resolution": "2k"}
}

Lấy ảnh dài sau khi hoàn tất

Sao chép id từ phản hồi POST vào TASK_ID rồi kiểm tra định kỳ cho đến khi trạng thái chuyển sang completed hoặc failed. Tác vụ tạo ảnh dài thường mất vài phút, đặc biệt với bố cục long ở độ phân giải 2k.

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Khi hoàn tất, đọc output.data[0].url. Mỗi yêu cầu tạo ra một tệp PNG dài hoàn chỉnh. Ở mức 2k, trang dài có thể vượt quá 50 MB, vì vậy hãy cấu hình thời gian chờ tải xuống và tỷ lệ hiển thị phù hợp. Xem thêm tài liệu tham khảo tác vụ và danh mục mã lỗi.

Giá

Mỗi yêu cầu hoàn tất tính một mức phí đầu ra (ecommerce theo resolution × length, hoặc webpage theo resolution) cộng thêm một phí ảnh tham chiếu cho mỗi ảnh đầu vào (tính từ ảnh đầu tiên). Yêu cầu thất bại không bị tính phí. Xem bảng giá hiện hành.

Lỗi thường gặp và lưu ý

Yêu cầu không hợp lệ sẽ trả về HTTP 400 trước khi tính phí. Các lỗi xác thực hay gặp gồm thiếu settings.skill, gửi ecommerce mà không có 1–3 URL refer_image, dùng refer_image trong chế độ webpage, yêu cầu 4k hoặc đặt trùng ID tham chiếu.

Hãy nêu rõ thứ tự từng mục trong mô tả—từ ảnh mở đầu đến bảng thông số hoặc chân trang—và chỉ đưa các dữ kiện sản phẩm đã xác thực để bố cục luôn chính xác. Xem Playground Kling Image 4.0 Long Image và lược đồ OpenAPI.