Kling Image 4.0 · API tạo ảnh
Kling Image 4.0 tạo ảnh độc lập, bộ ảnh đồng nhất, trang chi tiết sản phẩm và ảnh thiết kế web dạng dài.
Kling Image 4.0
Kling Image 4.0 tạo ảnh độc lập, bộ ảnh đồng nhất, trang chi tiết sản phẩm và ảnh thiết kế web dạng dài.
Điểm cuối
POST https://apimaster.ai/v1/kling/kling-image-4.0/image-generation·single,seriesPOST https://apimaster.ai/v1/kling/kling-image-4.0/long-image-generation·ecommerce,webpageGET https://apimaster.ai/v1/kling/kling-image-4.0/tasks/{task_id}
Tham số yêu cầu
| Trường | Giá trị |
|---|---|
contents |
JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image. |
contents[].text |
Cung cấp đúng một lời nhắc không rỗng. Dùng @id để tham chiếu từng tư liệu. |
contents[].id |
Mã định danh duy nhất cho mỗi tư liệu trong yêu cầu. |
contents[].url |
URL ảnh công khai hoặc Base64. JPG, JPEG và PNG tối đa 30 MB mỗi ảnh, hai cạnh ít nhất 300 px, tỷ lệ từ 2:5 đến 5:2. |
contents[].element_id |
Mã phần tử ảnh thuộc tài khoản của bạn hoặc mẫu có sẵn được hỗ trợ. Tính là một tham chiếu. |
settings.result_type |
single, series. Mặc định single. |
settings.n |
single → 1–9. Mặc định 1. |
settings.series_amount |
series → 2–10 / auto (2–10). Mặc định 4. |
settings.resolution |
single / series → 2k, 4k, 8k. Mặc định 2k. ecommerce / webpage → 1k, 2k. Mặc định 1k. |
settings.aspect_ratio |
single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Mặc định auto. |
settings.skill |
long-image-generation → ecommerce, webpage. |
settings.length |
ecommerce → short, medium, long. Mặc định medium. |
options.watermark_info.enabled |
boolean. Mặc định false. true → outputs[].watermark_url. |
options.callback_url |
URL webhook tùy chọn, cần đăng ký và xác minh trước trong tài khoản APIMaster. |
options.external_task_id |
Mã đối chiếu tùy chọn tối đa 128 byte, được trả về cùng tác vụ. |
Ảnh thường và bộ ảnh nhận tối đa 10 tham chiếu và phần tử cộng lại. Thương mại điện tử cần 1–3 refer_image. Trang web nhận tối đa một ảnh phong cách và một ảnh chủ thể.
Lời nhắc thường hỗ trợ 50.000 ký tự tiếng Anh hoặc 21.000 ký tự khác. Ảnh dài hỗ trợ tương ứng 166.000 và 71.000. Với nội dung hỗn hợp, tổng tỷ lệ so với hai giới hạn tối đa là 1.
Chế độ đơn tạo ảnh độc lập. Các ảnh trong bộ trả về theo thứ tự và dùng chung group_id. Mỗi yêu cầu ảnh dài trả về một ảnh hoàn chỉnh. length chỉ áp dụng cho thương mại điện tử và chọn khoảng 2–5, 6–10 hoặc 11–18 phần.
Ví dụ
single
curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/image-generation" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: kling-image-example-001" \
-d '{"contents":[{"type":"prompt","text":"A blue ceramic cup in soft daylight"}],"settings":{"resolution":"2k","aspect_ratio":"1:1"}}'
series
{
"contents": [
{
"type": "prompt",
"text": "Create two coordinated studio photographs of the blue ceramic cup in @cup. Show a front view and a detail close-up."
},
{
"type": "refer_image",
"id": "cup",
"url": "https://example.com/cup.png"
}
],
"settings": {
"result_type": "series",
"series_amount": 2,
"resolution": "4k",
"aspect_ratio": "3:4"
},
"options": {
"watermark_info": {
"enabled": true
},
"external_task_id": "campaign-cup-001"
}
}
ecommerce
{
"contents": [
{
"type": "prompt",
"text": "Design a product detail page for @cup. Include a hero image, material details, and care instructions."
},
{
"type": "refer_image",
"id": "cup",
"url": "https://example.com/cup.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "short",
"resolution": "1k"
}
}
webpage
{
"contents": [
{
"type": "prompt",
"text": "Design a long product landing page for a ceramic cup collection."
}
],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}
Kết quả tác vụ
Lưu task_id và truy vấn bằng cùng tài khoản. Khi thành công, outputs chứa URL từng ảnh cùng watermark_url và group_id nếu có. Khi thất bại, xem error.
curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/tasks/TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"task_id": "task_example",
"object": "image",
"model": "kling-image-4.0",
"status": "completed",
"outputs": [{"type": "image", "url": "https://example.com/generated.png"}]
}
Dùng lại Idempotency-Key khi gửi lại cùng yêu cầu. Nếu hết thời gian chờ, truy vấn tác vụ ban đầu.
Tính phí
Phí gồm số ảnh giao theo giá đầu ra và số tư liệu theo giá đầu vào. Xem giá hiện hành trên danh mục mẫu. Kling Image 4.0
