Image
Kling Image 4.0 Long Image
Erstelle E-Commerce-Produktdetailseiten und Webseiten-Designs in 1K oder 2K mit Kling Image 4.0 Long Image und frage anschließend die fertige PNG-URL ab.
Sende eine JSON-Anfrage an POST /v1/images/generations mit der Modell-ID kling-image-4-0-long-image. Speichere die zurückgegebene Task-ID und frage anschließend GET /v1/tasks/{id} ab, bis das einzelne hohe PNG fertig ist.
Schnellbeispiel
Diese Anfrage erstellt ein 1K-Webseiten-Layout aus einer Textbeschreibung. Speichere deinen API-Schlüssel in der Umgebungsvariablen 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"}
}'Endpunkt und Header
Sende JSON an POST https://api.seedrouter.ai/v1/images/generations mit Content-Type: application/json und Authorization: Bearer YOUR_API_KEY. Bewahre den Schlüssel ausschließlich auf deinem Server auf.
Parameter
| Feld | Typ | Werte und Standardwerte |
|---|---|---|
model | string, erforderlich | kling-image-4-0-long-image |
contents | array, erforderlich | Ein prompt-Eintrag sowie modusspezifische Referenzbild-Einträge. |
contents[].type | string, erforderlich | prompt, refer_image (nur ecommerce, 1–3 erforderlich), style_refer_image (nur webpage, höchstens 1) oder subject_refer_image (nur webpage, höchstens 1). element wird nicht unterstützt. |
contents[].text | string | Erforderlich für prompt. Limit für reines Englisch: 166.000 Zeichen, für nicht-englischen Text: 71.000 Zeichen. Gemischter Text muss english / 166000 + non_english / 71000 <= 1 erfüllen. |
contents[].url | string | Erforderlich für jeden Bildeintrag. Öffentliche HTTP(S)-URL zu einer JPEG- oder PNG-Datei bis 30 MB, mindestens 300 px pro Seite, Seitenverhältnis zwischen 2:5 und 5:2. |
contents[].id | string | Optionale eindeutige Referenz-ID über alle Bildeinträge der Anfrage hinweg. Sprich sie im Prompt als @id an. |
settings.skill | string, erforderlich | ecommerce für Produktdetailseiten oder webpage für Webseiten-Designs. |
settings.length | string | short (ca. 2–5 Abschnitte), medium (Standard, ca. 6–10 Abschnitte) oder long (ca. 11–18 Abschnitte). Gilt nur für ecommerce; wird bei webpage ignoriert. |
settings.resolution | string | 1k (Standard, 1024 px breit) oder 2k (2048 px breit). Die Höhe passt sich dem Inhalt an. 4k wird nicht unterstützt. |
options.watermark_info.enabled | boolean | Optional. Nur false wird unterstützt. |
E-Commerce-Produktdetailseite
Der ecommerce-Modus erfordert 1 bis 3 refer_image-Einträge. Referenziere jedes Foto im Prompt über seine id.
{
"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"}
}Webseiten-Design mit Stil- und Motivreferenz
Der webpage-Modus akzeptiert optional style_refer_image (höchstens 1) und subject_refer_image (höchstens 1). Lass settings.length im webpage-Modus weg.
{
"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"}
}Langbild abrufen
Kopiere id aus der POST-Antwort in TASK_ID und frage den Status ab, bis completed oder failed zurückkommt. Langbild-Tasks dauern üblicherweise mehrere Minuten, insbesondere bei Layouts mit long + 2k.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Lies nach Abschluss output.data[0].url aus. Jede Anfrage erzeugt ein vollständiges hohes PNG. Bei 2k können lange Seiten über 50 MB groß werden – plane Download-Timeouts und Skalierung im Viewer entsprechend ein. Sieh dir die Task-Referenz und das Fehlerverzeichnis an.
Preise
Jede abgeschlossene Anfrage berechnet einen Ausgabestufen-Tarif (ecommerce nach resolution × length oder webpage nach resolution) sowie eine Referenzbild-Gebühr pro Eingabebild (ab dem ersten Foto). Für eine fehlgeschlagene Anfrage wird nichts berechnet. Sieh dir die aktuellen Tarife an.
Fehler und Tipps
Ungültige Anfragen liefern HTTP 400 vor jeder Abrechnung zurück. Häufige Validierungsfehler sind ein fehlendes settings.skill, ecommerce ohne 1–3 refer_image-URLs, refer_image im webpage-Modus, das Anfordern von 4k oder doppelte Referenz-IDs.
Gib die genaue Reihenfolge der Abschnitte direkt im Prompt an – vom Hero-Banner bis zu den Spezifikationen oder dem Footer – und verwende nur geprüfte Produktfakten, damit das Layout verlässlich bleibt. Sieh dir den Kling Image 4.0 Long Image Playground und das OpenAPI-Schema an.
