Claude Opus 5.5 đã có trên SeedRouter

Image

Kling Image 4.0

View Markdown

Tạo ảnh 2K hoặc 4K với Kling Image 4.0. Dùng ảnh tham chiếu có tên, tạo các biến thể ảnh độc lập hoặc một chuỗi ảnh liên kết, sau đó kiểm tra trạng thái cho đến khi nhận được URL ảnh 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. Lưu ID tác vụ được trả về. Cùng endpoint này chấp nhận cả mô tả chỉ có văn bản và mô tả có hướng dẫn bằng ảnh tham chiếu.

Ví dụ nhanh

Yêu cầu này tạo một ảnh tĩnh vuông ở độ phân giải 2K. 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",
    "contents": [
      {"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
    ],
    "settings": {"resolution": "2k", "aspect_ratio": "1:1"}
  }'

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. Giữ khóa trên máy chủ của bạn.

Tham số

TrườngKiểu dữ liệuGiá trị và mặc định
modelchuỗi, bắt buộckling-image-4-0
contentsmảng, bắt buộcMột câu lệnh và từ 0 đến 10 ảnh tham chiếu.
contents[].typechuỗi, bắt buộcprompt hoặc refer_image.
contents[].textchuỗiBắt buộc cho câu lệnh. Giới hạn 50.000 ký tự đối với tiếng Anh và 21.000 ký tự đối với ngôn ngữ khác. Với văn bản kết hợp nhiều ngôn ngữ, tổng tỷ lệ sử dụng giới hạn của từng ngôn ngữ không được vượt quá một.
contents[].urlchuỗiBắt buộc cho từng ảnh tham chiếu. Dùng URL HTTP(S) có thể truy cập được cho ảnh JPEG hoặc PNG, tối đa 30 MB. Chiều rộng và chiều cao đều phải từ 300 pixel trở lên, tỷ lệ chiều rộng trên chiều cao phải nằm trong khoảng từ 2:5 đến 5:2.
contents[].idchuỗiTên riêng tùy chọn cho ảnh tham chiếu. Đề cập tên đó dưới dạng @name trong câu lệnh.
settings.result_typechuỗisingle (mặc định) để tạo các ảnh độc lập hoặc series để tạo các ảnh có liên quan với nhau.
settings.nsố nguyênTừ 1 đến 9 ảnh độc lập. Mặc định là 1. Chỉ dùng ở chế độ single.
settings.series_amountsố nguyên hoặc chuỗiỞ chế độ series, tạo từ 2 đến 4 ảnh, mặc định là 4. Ở chế độ single, trường này bị bỏ qua và có thể là số nguyên từ 2 đến 10 hoặc chuỗi auto.
settings.resolutionchuỗi2k (mặc định) hoặc 4k.
settings.aspect_ratiochuỗiauto (mặc định), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 hoặc 21:9.
options.watermark_info.enabledgiá trị booleanKhông bắt buộc. Chỉ hỗ trợ false.

Tạo chuỗi ảnh từ ảnh tham chiếu

Thay URL ví dụ bằng URL công khai của ảnh sản phẩm của bạn. Ví dụ này yêu cầu tạo ba ảnh liên kết với nhau. Giữ chỉ dẫn cho từng khung hình trong cùng một câu lệnh.

{
  "model": "kling-image-4-0",
  "contents": [
    {"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
    {"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
  ],
  "settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}

Lấy tất cả ảnh

Sao chép id từ phản hồi POST vào TASK_ID. Gửi yêu cầu đến endpoint này để kiểm tra trạng thái bằng cùng khóa cho đến khi tác vụ có trạng thái completed hoặc failed.

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

Khi tác vụ hoàn tất, đọc tất cả URL trong output.data[].url. Một tác vụ có thể trả về nhiều ảnh. Nếu việc kiểm tra trạng thái bị gián đoạn, hãy tra cứu lại bằng ID ban đầu. Xem tài liệu tham khảo về tác vụ để biết vòng đời tác vụ và danh mục lỗi để xem mã lỗi.

Giá

Tổng chi phí được tính bằng số ảnh đầu ra ở độ phân giải yêu cầu nhân với mức phí hiện hành cho mỗi ảnh, cộng thêm phí ảnh tham chiếu cho mỗi ảnh đầu vào. Bốn ảnh 4K cùng hai ảnh tham chiếu có chi phí bằng phí đầu ra 4K của bốn ảnh cộng với phí của hai ảnh tham chiếu. Yêu cầu thất bại không bị tính phí. Xem mức phí hiện hành.

Lỗi và mẹo

Dữ liệu đầu vào không hợp lệ sẽ trả về lỗi yêu cầu. Kiểm tra xem có thiếu nội dung câu lệnh, ID ảnh tham chiếu bị trùng hoặc cài đặt độ phân giải hay chuỗi ảnh không được hỗ trợ hay không. Nếu lần gọi ban đầu đã trả về ID tác vụ, hãy truy vấn ID đó trước khi quyết định có cần gửi yêu cầu khác hay không.

Với mô tả dùng nhiều ảnh tham chiếu, hãy đặt tên riêng cho từng đối tượng và cho mô hình biết mỗi ảnh tham chiếu cung cấp đặc điểm hình ảnh nào. Nêu chỉ dẫn máy quay và trình tự cảnh quay trong câu lệnh. Xem playground Kling Image 4.0 và lược đồ OpenAPI.