Kling Image 4.0 Long Image: Tutorial
Erstelle 2K-Weblayouts und Produktdetailseiten mit Kling Image 4.0 Long Image: zwei echte PNG-Läufe, cURL-Beispiele, Polling-Schritte und Live-Preise.
Als Markdown lesenKlassische Bildmodelle liefern immer nur ein einzelnes Bild pro Durchlauf. Sobald du damit eine Produktdetailseite oder eine komplette Launch-Webseite bauen willst, landest du bei sechs unzusammenhängenden Bannern und kämpfst im Layout-Programm gegen abweichende Ränder, springende Schriften und uneinheitliche Produktgrößen. Kling Image 4.0 Long Image geht anders vor: Eine einzige API-Anfrage liefert ein durchgehendes vertikales PNG, von oben bis unten strukturiert, mit fester 1K- (1024 px) oder 2K-Breite (2048 px) und einer Höhe, die sich nach den Abschnitten in deinem Briefing richtet.
Am 19. November 2026 haben wir zwei 2K-Läufe über den SeedRouter-Endpunkt /v1/images/generations gestartet, um beide Modi mit realitätsnahen Briefings zu testen. Der erste Lauf nutzte den webpage-Modus rein aus Text und lieferte eine Launch-Seite mit 2048 × 16.385 Pixeln für eine fiktive Studio-Kopfhörermarke (17 MB, 169 Sekunden). Der zweite Lauf nutzte den ecommerce-Modus in Länge medium mit zwei vorhandenen Schmuck-Referenzfotos und erzeugte eine Produktdetailseite mit 2048 × 19.533 Pixeln (25 MB, 261 Sekunden). Unten kannst du beide kompletten Seitenverläufe prüfen, jedes Briefing direkt im Kling Image 4.0 Long Image Playground ausprobieren und die exakten Stufentarife in der Live-Tabelle weiter unten vergleichen.
Wähle vor der ersten Zeile zwischen ecommerce und webpage
Das Pflichtfeld settings.skill bestimmt sowohl die visuelle Layout-Grammatik als auch die zulässigen API-Parameter. Betrachte die beiden Modi als getrennte Verträge und nicht bloß als optische Stil-Presets.
Nutze ecommerce, wenn dir bereits echte Produktfotos vorliegen und du eine vertikale Produktdetailseite (PDP) für einen Online-Shop oder Marktplatz brauchst. Im ecommerce-Modus musst du zwischen einem und drei refer_image-Einträgen in contents übergeben und steuerst die vertikale Abschnittstiefe über settings.length (short, medium oder long, Standard ist medium). Anfragen ohne Produktreferenz werden noch vor der Abrechnung abgelehnt.
Nutze webpage, wenn du eine Marken-Landingpage, eine Launch-Seite oder ein redaktionelles Web-Layout entwirfst. Im webpage-Modus sind Referenzen optional: Du kannst rein mit Text arbeiten oder höchstens ein style_refer_image für Farbpalette und Layoutrhythmus sowie höchstens ein subject_refer_image für ein zentrales Produkt mitgeben. Sende im webpage-Modus weder refer_image noch settings.length; beide Felder gehören strikt zu ecommerce-Anfragen und lösen bei Vermischung einen Validierungsfehler aus.
| Einstellung oder Eingabe | ecommerce-Modus | webpage-Modus |
|---|---|---|
settings.skill | "ecommerce" (erforderlich) | "webpage" (erforderlich) |
settings.length | "short", "medium" (Standard) oder "long" | Vollständig weglassen |
settings.resolution | "1k" (1024 px breit) oder "2k" (2048 px breit) | "1k" (1024 px breit) oder "2k" (2048 px breit) |
refer_image-Einträge | Erforderlich: 1 bis 3 öffentliche JPEG/PNG-URLs | Nicht zulässig |
style_refer_image / subject_refer_image | Nicht zulässig | Optional: jeweils höchstens 1 |
Keiner der beiden Modi akzeptiert 4k, Batch-Zähler (n) oder Seitenverhältnisse. Jeder erfolgreiche Task liefert genau eine hohe PNG-URL unter output.data[0].url.
Lauf 1: Ein reines Text-Webseiten-Layout in 2K (2048 × 16.385)

Oben siehst du alle vier vertikalen Viertel unseres webpage-2K-Laufs nebeneinander. Das Briefing verlangte eine dunkle Launch-Seite im Schweizer Industriedesign für einen offenen Planar-Kopfhörer namens S-01 Reference Planar: schmale Navigationsleiste, Dreiviertel-Hero-Foto, dreispaltige Akustik-Highlights, CNC-Schnittansicht, technische Spezifikationstabelle mit konkreten elektrischen Werten und ein ruhiger Footer.
Schau dir genau an, was in einem einzigen Durchgang konsistent geblieben ist. Über 16.385 vertikale Pixel hinweg blieben der dunkle Anthrazit-Hintergrund, die Serif-Display-Überschriften und die gebürstete Aluminium-Geometrie des Kopfhörers von der oberen Navigationsleiste bis zur Fünf-Farben-Leiste und Spezifikationstabelle stimmig. Alle angeforderten elektrischen Kennzahlen wurden sauber lesbar gerendert (106 mm Iso-Planar, 32 Ohms, 98 dB/mW, 8 Hz–52 kHz, 410 g). Ein kleines Detail fiel bei der Prüfung des vollen PNGs bei 100 % Zoom auf: Der Prompt sah hinter der Spezifikationstabelle ein helles Alabaster-Band vor, doch das Modell ließ die Tabelle auf dunklem Schiefer und setzte stattdessen das Newsletter-Band darunter auf ein helleres Grau. Wenn ein bestimmter Hintergrundwechsel für die Übergabe an die Entwicklung verbindlich ist, nutze die Ausgabe als visuelle Art Direction und baue den entsprechenden HTML-Abschnitt auf Basis der generierten Fotografie gezielt nach.
Ein starkes webpage-Briefing ähnelt eher einer Wireframe-Gliederung als einem klassischen Einzelbild-Prompt. Stelle globale Design-Tokens an den Anfang (Hintergrund-Hexwert, Oberflächenmaterial, Akzentfarbe, Rasterdisziplin) und nummeriere danach jeden Abschnitt von oben nach unten mit konkretem Text für Überschriften und Kennzahlen. Vage Überschriften provozieren Platzhaltertext.
curl --fail-with-body -sS 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 vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
}],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}' -o solstice-task.json
jq -er '.id' solstice-task.jsonBeachte, dass settings.length in diesem Payload komplett fehlt und contents ausschließlich den prompt-Eintrag enthält. Den vollständigen Parametervertrag findest du in der API-Referenz zu Kling Image 4.0 Long Image. [1]
Lauf 2: Eine 2K-E-Commerce-Detailseite mit zwei Referenzen (2048 × 19.533)

Für den zweiten Lauf haben wir settings.skill auf "ecommerce" gestellt, settings.length auf "medium" gesetzt, resolution bei "2k" belassen und zwei vorhandene Schmuckfotos als refer_image-Einträge übergeben: eine Makroaufnahme eines skulpturalen Gold-Orchideenohrrings mit id: "earring" sowie ein redaktionelles Gewächshaus-Porträt einer Frau mit demselben Ohrring unter id: "model".
Im Prompt sprachen wir diese beiden Bilder in den jeweiligen Abschnitten direkt über @earring und @model an. Die API übersetzt deine benannten IDs automatisch in Positionsreferenzen – du musst also keine Indizes von Hand abzählen. Jedes Referenzfoto muss eine öffentliche JPEG- oder PNG-URL mit bis zu 30 MB, mindestens 300 px pro Kante und einem Seitenverhältnis zwischen 2:5 und 5:2 sein.

Dieser einzelne medium-2K-Aufruf erzeugte 19.533 vertikale Pixel mit sechs vollständigen E-Commerce-Modulen: einem Produkt-Hero auf Champagnerseide, einem poetischen Design-Inspirationsband, einem sauberen Studio-Freisteller neben einer sechszeiligen Produkttabelle (Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box), einem On The Ear-Porträt treu zu @model, einem Produktgrid mit sechs Perspektiven (Front, Side, Back, Core Detail, Hook Detail, Profile) sowie dem oben vergrößerten Detaildiagramm Craft And Beauty.
Bei der Kontrolle in voller Auflösung fiel allerdings auch eine Schwachstelle auf, die du kennen solltest, bevor du generierte Produktdetailseiten direkt in einen Live-Katalog übernimmst. Während die Spezifikationstabelle den exakten Modellnamen Phalaenopsis No. 4 Drop Earring korrekt abbildete und jede Diagrammbeschriftung sauber geschrieben war, verkürzte der oberste Hero-Banner Botanical Series zu BOTA SERIES und BOTA — Drop Earring, statt den angeforderten Markennamen L'ORCHIDÉE abzudrucken. Das ist ein typisches Muster bei Text in langen Layouts: Kurze Labels und Tabellenzeilen bleiben erstaunlich stabil, während stilisierte Großbuchstaben-Wortmarken im Hero gelegentlich abdriften. Prüfe die Hero-Überschrift immer in voller Breite und lege rechtlich verbindliche Logos oder Pflichtangaben als Vektor-Overlay in dein Shop-Template.
curl --fail-with-body -sS 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": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
},
{
"type": "refer_image",
"id": "earring",
"url": "https://example.com/assets/gold-orchid-earring.png"
},
{
"type": "refer_image",
"id": "model",
"url": "https://example.com/assets/editorial-portrait.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}' -o orchidee-task.json
jq -er '.id' orchidee-task.jsonWenn du stattdessen Referenzen im webpage-Modus einsetzt, gilt eine klare Zuordnungsregel: Nutze style_refer_image für die visuelle Richtung und subject_refer_image für ein zentrales Produkt, vergib jeweils eine eindeutige alphanumerische id (1 bis 32 Zeichen ohne Leerzeichen) und referenziere sie im Prompt als @id. Verwende innerhalb desselben contents-Arrays niemals doppelte IDs.
Geduldig pollen und große 2K-PNG-Downloads einplanen
Hohe vertikale Layouts benötigen spürbar mehr Rechenzeit als gewöhnliche Einzelbilder und liefern deutlich größere Dateien. Wer sie wie eine Fünf-Sekunden-Thumbnail-API behandelt, riskiert Client-Timeouts oder versehentliche Doppelabrechnungen.
In unseren Läufen vom 19. November war die Webseite mit 2048 × 16.385 Pixeln nach 169 Sekunden fertig (17 MB), und die mittlere E-Commerce-Seite mit 2048 × 19.533 Pixeln nach 261 Sekunden (25 MB). Lange 2K-E-Commerce-Seiten können über sieben Minuten laufen und mehr als 50 MB erreichen. Speichere die Task-ID sofort nach der Antwort von POST /v1/images/generations, frage GET /v1/tasks/{id} alle 15 bis 20 Sekunden ab und sende niemals einen zweiten POST, nur weil eine Terminalsitzung abgebrochen oder ein Client in ein Timeout gelaufen ist. [2]
TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.jsonSobald status auf completed steht, liest du die einzelne PNG-URL aus output.data[0].url aus und streamst sie mit großzügigem Timeout auf die Platte:
IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.pngIn Backend-Workern solltest du das gesamte PNG nicht in einen kleinen festen Speicherpuffer laden, bevor es auf Festplatte oder Object Storage geschrieben wird. Streame den HTTP-Body direkt in eine Datei, prüfe die Bildabmessungen vor dem Zuschneiden für mobile Shops und wandle Anzeigevorschauen in WebP um, während du das Original-PNG für Druck oder Slice-Exporte archivierst.
Budget über alle acht Ausgabestufen und Referenzbilder planen
Die Kosten für Kling Image 4.0 Long Image hängen von drei Einstellungen ab: skill (ecommerce vs. webpage), length (short, medium oder long im ecommerce-Modus) und resolution (1k vs. 2k). Jedes Eingabe-Referenzbild (refer_image, style_refer_image oder subject_refer_image) addiert eine Eingabebild-Gebühr – ab dem ersten Foto, ohne Freikontingent.
Daraus ergibt sich eine einfache Entwurfsstrategie. Wenn du für einen E-Commerce-Katalog an Abschnittsreihenfolge, Überschriftenrhythmus und Farbhierarchie feilst, teste zuerst in 1k mit short oder medium, prüfe den vertikalen Fluss und wechsle erst dann zu 2k, wenn das Briefing steht. Bei Webseiten-Layouts ist der Abstand zwischen 1k und 2k klein genug, dass sich 2k meist direkt lohnt, sobald du scharfe Spezifikationstabellen mit kleiner Schrift brauchst. Unser erster Lauf wurde exakt zum webpage-2K-Tarif abgerechnet, unser zweiter zum ecommerce-medium-2K-Tarif plus zwei Eingabebild-Gebühren. Für eine fehlgeschlagene Anfrage wird nichts berechnet. Prüfe die aktuellen Live-Werte unten oder berechne deine exakte Kombination im Preisrechner für Kling Image 4.0 Long Image. [3]
Was Kling Image 4.0 Long Image kostet
| Kategorie | Preise (USD) |
|---|---|
| Ecommerce · 1K · short | 0,2269 $ |
| Ecommerce · 2K · short | 0,2723 $ |
| Ecommerce · 1K · medium | 0,4538 $ |
| Ecommerce · 2K · medium | 0,5294 $ |
| Ecommerce · 1K · long | 0,7563 $ |
| Ecommerce · 2K · long | 0,8319 $ |
| Webpage · 1K | 0,5294 $ |
| Webpage · 2K | 0,5748 $ |
| Referenzbild | 0,003025 $ |
Häufige Fragen
Wie wähle ich im ecommerce-Modus zwischen short, medium und long?
Zähle zuerst die eigenständigen Module, die dein Produkt wirklich braucht, bevor du length festlegst. Eine short-Seite trägt drei bis vier konzentrierte Bänder wie Hero, Hauptvorteile und einen kompakten Spezifikationsblock. Eine medium-Seite bietet bequem Platz für sechs Abschnitte wie im Schmuck-Lauf oben (Hero, Story, Studio-Freisteller, Spezifikationstabelle, Tragefoto, Mehrwinkel-Grid und Detaildiagramm). Hebe dir long für technische Hardware oder Multi-SKU-Seiten auf, bei denen du Vergleichstabellen, Schritt-für-Schritt-Anwendungen und Verpackungsübersichten unterbringen willst, ohne die Typografie zu stauchen.
Warum hat meine webpage-Anfrage HTTP 400 zurückgegeben?
Die beiden häufigsten Validierungsfehler sind das Mitsenden von settings.length bei skill: "webpage" sowie das Kennzeichnen eines Referenzfotos mit type: "refer_image" statt style_refer_image oder subject_refer_image. Beide Felder gehören ausschließlich in den ecommerce-Modus. Prüfe außerdem, ob dein Prompt innerhalb des gewichteten Zeichenlimits bleibt (en / 166000 + non_en / 71000 <= 1, geprüft nach dem Mapping der @id-Verweise) und ob resolution auf "1k" oder "2k" steht.
Sollte ich das fertige PNG für einen Live-Shop zuschneiden?
Ja. Ein PNG mit 2048 × 19.533 Pixeln ist unkomprimiert 17 bis 25 MB groß und deutlich zu schwer, um es im Mobilfunknetz als einzelnes <img>-Tag auszuliefern. Schneide die fertige Seite entlang der horizontalen Abschnittsgrenzen in einzelne Segmente, komprimiere jedes Segment als WebP oder AVIF für schnelles progressives Laden und ersetze rechtlich wichtige Angaben, Preise oder Kauf-Buttons durch echten HTML-Text. Bevor du deine Pipeline automatisierst, kannst du Prompts und komplette Langbilder direkt im Kling Image 4.0 Long Image Playground testen.



