Kling Image 4.0 · API obrazów
Kling Image 4.0 generuje niezależne obrazy, spójne serie, karty produktów i długie projekty stron.
Kling Image 4.0
Kling Image 4.0 generuje niezależne obrazy, spójne serie, karty produktów i długie projekty stron.
Punkty końcowe
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}
Parametry żądania
| Pole | Wartość |
|---|---|
contents |
JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image. |
contents[].text |
Podaj jeden niepusty prompt. Użyj @id, aby wskazać konkretny materiał. |
contents[].id |
Unikalny identyfikator każdej referencji w danym żądaniu. |
contents[].url |
Publiczny URL lub Base64. JPG, JPEG lub PNG do 30 MB na plik, oba boki co najmniej 300 px, proporcje od 2:5 do 5:2. |
contents[].element_id |
Identyfikator elementu graficznego z własnego konta lub obsługiwanego presetu. Liczy się jako jedna referencja. |
settings.result_type |
single, series. Domyślnie single. |
settings.n |
single → 1–9. Domyślnie 1. |
settings.series_amount |
series → 2–10 / auto (2–10). Domyślnie 4. |
settings.resolution |
single / series → 2k, 4k, 8k. Domyślnie 2k. ecommerce / webpage → 1k, 2k. Domyślnie 1k. |
settings.aspect_ratio |
single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Domyślnie auto. |
settings.skill |
long-image-generation → ecommerce, webpage. |
settings.length |
ecommerce → short, medium, long. Domyślnie medium. |
options.watermark_info.enabled |
boolean. Domyślnie false. true → outputs[].watermark_url. |
options.callback_url |
Opcjonalny URL webhooka zarejestrowany i zweryfikowany na koncie APIMaster. |
options.external_task_id |
Opcjonalny identyfikator korelacji do 128 bajtów zwracany wraz z zadaniem. |
Zwykłe obrazy i serie obsługują łącznie 10 referencji i elementów. Karta produktu wymaga 1–3 refer_image. Strona WWW przyjmuje po jednej referencji stylu i obiektu.
Zwykły prompt: 50 000 znaków angielskich lub 21 000 innych. Długie obrazy: odpowiednio 166 000 i 71 000. W tekście mieszanym suma ułamków względem limitów nie może przekraczać 1.
Tryb pojedynczy tworzy niezależne obrazy. Powiązane obrazy serii wracają w kolejności ze wspólnym group_id. Długi obraz to jeden kompletny plik. length dotyczy kart produktów i odpowiada około 2–5, 6–10 lub 11–18 sekcjom.
Przykłady
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"
}
}
Wyniki zadania
Zapisz task_id i odpytuj z tego samego konta. Po sukcesie outputs zawiera adresy obrazów oraz opcjonalnie watermark_url i group_id. W razie błędu odczytaj 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"}]
}
Przy ponowieniu użyj tego samego Idempotency-Key. Po upływie limitu czasu sprawdź pierwotne zadanie.
Rozliczenie
Opłata obejmuje dostarczone obrazy według stawek wyjściowych oraz materiały według stawek wejściowych. Aktualne ceny są w katalogu. Kling Image 4.0
