GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Alle Anleitungen

· reAPI Team

Kling Image 4.0 Long Image: Tutorial

Erfahre, wie du Kling Image 4.0 Long Image auf reAPI für Ecommerce-Detailseiten und Webpage-Layouts nutzt – mit Modusregeln, Referenz-IDs, Preisen und Prüfschritten.

Kling Image 4.0 Long Image: Tutorial

Die meisten Bildgeneratoren liefern dir jeweils nur ein einzelnes Quadrat- oder 16:9-Bild. Wenn du eine vollständige Ecommerce-Produktdetailseite oder eine durchgehende vertikale Landingpage benötigst, zerstört das Zusammenfügen von sechs einzelnen Standbildern fast immer Lichtstimmung, Abstände und Typografie an jeder Nahtstelle. Kling Image 4.0 Long Image löst dieses Problem, indem es in einer einzigen Anfrage ein durchgehendes hohes PNG vom oberen Hero bis zum Footer rendert.[1]

Dieses Tutorial führt dich durch den genauen Vertrag auf reAPI für sowohl den webpage- als auch den ecommerce-Modus – einschließlich Referenzbild-Regeln, @id-Erwähnungen, Auflösungsplanung für 1K gegenüber 2K, aktueller reAPI-Preise pro Seite (Stand: 20. November 2026) sowie der für hohe PNG-Dateien erforderlichen Abfrage- und Dateiprüfungen.[2]

Kurzübersicht

  • Zwei verschiedene Skills: settings.skill ist bei jedem Aufruf erforderlich. Wähle webpage für vollständige Scroll-Landingpage-Konzepte (0 bis 2 optionale Referenzen, settings.length weglassen) oder ecommerce für Produktdetailseiten (1 bis 3 erforderliche refer_image-Fotos plus die Tiefe short, medium oder long).[1]
  • Ein hohes PNG pro Aufgabe: Die Ausgabebreite ist fest auf 1K (1024 px) oder 2K (2048 px) eingestellt, während sich die vertikale Höhe an die Abschnitte in deinem Briefing anpasst. 4k wird nicht unterstützt.[2]
  • Referenzrollen dürfen nicht gemischt werden: refer_image funktioniert nur im ecommerce-Modus; style_refer_image und subject_refer_image funktionieren nur im webpage-Modus. Element-Referenzen werden nicht unterstützt.[2]
  • Abrechnung pro Seite (Pay-per-page): Stand 20. November 2026 reichen die reAPI-Tarife von 0,2269 $ (ecommerce, short, 1k) bis 0,8319 $ (ecommerce, long, 2k), wobei webpage bei 0,5294 $ (1k) oder 0,5748 $ (2k) liegt, zuzüglich 0,003025 $ pro Eingabe-Referenzbild ab dem ersten Bild. Siehe die Live-Preistabelle.[3]
  • Lange Renderzeiten und große Dateien einplanen: Mehrteilige Renderings dauern typischerweise mehrere Minuten, und hohe 2K-PNGs können über 50 MB groß werden. Dimensioniere HTTP-Download-Timeouts und Bildbetrachter entsprechend.[2]

Beginne mit einem 1K-Webpage-Briefing

Bevor du mehrere Produktaufnahmen hochlädst oder für ein langes 2K-Layout bezahlst, sende zunächst eine einzelne reine Text-Anfrage im Modus webpage an Kling Image 4.0 Long Image in 1K-Breite. Ein 1K-Webpage-Job ermöglicht es dir, das vertikale Abschnittstempo, den Farbkontrast und die visuelle Hierarchie zu prüfen, ohne zusätzliche Zeit für hochauflösende Pixel oder das Einrichten von Referenzen aufzuwenden.

Liste jeden Abschnitt in exakter Reihenfolge von oben nach unten in einem einzigen prompt-Element auf. Benenne das Hero-Banner, die mittleren Feature-Bänder, jedes Raster oder jeden Vergleichsstreifen sowie den abschließenden Footer-Block. Eine vage Anfrage wie „make a modern coffee website“ überlässt Abschnittsanzahl und visuellen Rhythmus dem Zufall, während dir eine nummerierte vertikale Gliederung bei der Prüfung des Ergebnisses eine konkrete Checkliste liefert.

curl https://reapi.ai/api/v1/images/generations \
  -H 'Authorization: Bearer YOUR_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. Section 1: full-bleed hero banner with warm morning light over a pour-over bar and headline space on the left. Section 2: three single-origin bean cards with origin notes and roast level tags. Section 3: brewing guide strip showing grind size, water temperature, and pour timing. Section 4: minimal footer with cafe address and opening hours."
      }
    ],
    "settings": {
      "skill": "webpage",
      "resolution": "1k"
    }
  }'

Der Endpunkt gibt ein JSON-Objekt mit deiner Aufgaben-id und status: "processing" zurück. Speichere diese ID sofort. Anders als Einzelbild-Endpunkte, die in zehn Sekunden fertig sind, benötigt ein durchgehendes mehrteiliges Layout länger zum Rendern. Frage GET /api/v1/tasks/{id} mit demselben Bearer-Schlüssel ab, bis status auf completed oder failed wechselt.[4]

Ecommerce- oder Webpage-Modus in Kling Image 4.0 Long Image wählen

Jede Anfrage an Kling Image 4.0 Long Image erfordert settings.skill. Die Wahl des richtigen Modus ist wichtig, da jeder Skill eigene Referenztypen und Längensteuerungen erzwingt und eine Vermischung noch vor der Abrechnung einen Validierungsfehler auslöst.[2]

Regelecommerce-Moduswebpage-Modus
ZielausgabeMehrteilige ProduktdetailseiteVollständiges Scroll-Webpage-Layout
Erlaubte ReferenztypenNur refer_imageNur style_refer_image und subject_refer_image
Referenzanzahl1 bis 3 erforderlich0 bis 1 Stil und 0 bis 1 Motiv (beide optional)
settings.lengthshort, medium (Standard) oder longIgnoriert (in der Anfrage weglassen)
settings.resolution1k (Standard) oder 2k1k (Standard) oder 2k
options.watermark_info.enabledNur falseNur false

Nutze den ecommerce-Modus in Kling Image 4.0 Long Image immer dann, wenn du bereits echte Produktfotografie hast und eine stimmige vertikale Angebotsseite für einen Onlineshop benötigst. Die drei Längenstufen entsprechen ungefähren Abschnittszahlen aus der Dokumentation des Anbieters: short zielt auf etwa 2 bis 5 Abschnitte, medium auf etwa 6 bis 10 Abschnitte und long auf etwa 11 bis 18 Abschnitte.[1]

Nutze den webpage-Modus in Kling Image 4.0 Long Image, wenn du den Prototyp einer Marken-Landingpage, Launch-Seite oder redaktionellen Microsite erstellst, bei der du aus reinem Text startest oder eine visuelle Stilreferenz mit einem Hero-Motivfoto kombinierst. Da der webpage-Modus die vertikale Tiefe anhand deiner Abschnittsliste statt eines length-Enums bestimmt, hält das Weglassen von settings.length Anfragen sauber und schema-konform.

Benannte Referenzen ohne Validierungsfehler verdrahten

Referenzbilder sind der wichtigste Hebel, um ein echtes Produkt über einen Scroll in Kling Image 4.0 Long Image hinweg wiedererkennbar zu halten. Jedes Referenzelement in contents nimmt einen type, eine öffentlich erreichbare HTTP- oder HTTPS-url und eine optionale eindeutige id entgegen. Base64-Strings und data:-URIs werden vom reAPI-Gateway abgelehnt.[2]

Jede Referenzdatei muss vor dem Absenden vier Formatprüfungen erfüllen:

  • Format: Nur JPEG oder PNG.
  • Dateigröße: Höchstens 30 MB pro Bild.
  • Mindestabmessungen: Mindestens 300 Pixel sowohl in der Breite als auch in der Höhe.
  • Seitenverhältnis: Zwischen 2:5 und 5:2.

Prüfe jeden Referenzlink in einem abgemeldeten Browserfenster, bevor du den Endpunkt aufrufst. Asset-URLs hinter ablaufenden Dashboard-Cookies schlagen fehl, wenn der Render-Worker sie abruft.

Beispiel für eine Ecommerce-Produktdetailseite

Im ecommerce-Modus von Kling Image 4.0 Long Image gibst du ein bis drei refer_image-Einträge an und vergibst für jede Perspektive eine klare kurze id, etwa front und spout. Erwähne diese Namen im Prompt direkt als @front und @spout, damit das Layout weiß, welches Foto das Hero-Banner verankert und welches ein Makro-Detailband steuert.

{
  "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 a medium ecommerce product detail page for the brushed-steel gooseneck kettle in @front. Section 1: full-bleed hero showing @front on warm travertine stone with clean headline space. Section 2: three core benefit callouts covering pour precision, balanced handle ergonomics, and stainless body durability. Section 3: close-up detail band highlighting the curved spout from @spout with flow-control annotations. Section 4: morning pour-over brewing lifestyle scene. Section 5: care instructions and verified specification list."
    }
  ],
  "settings": {
    "skill": "ecommerce",
    "length": "medium",
    "resolution": "2k"
  }
}

Beispiel für Webpage-Stil- und Motivreferenz

Im webpage-Modus von Kling Image 4.0 Long Image trennst du die ästhetische Richtung vom eigentlichen Produkt. Hänge höchstens ein style_refer_image an, um Farbpalette, Rasterrhythmus und Typografie-Anmutung zu steuern, und höchstens ein subject_refer_image, um ein physisches Objekt präzise abzubilden. Jede id innerhalb der Anfrage muss eindeutig sein.

{
  "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 tall watch launch webpage that matches the pale sandstone palette and editorial grid rhythm of @layout while showcasing @watch. Section 1: hero header featuring @watch at center-right. Section 2: three-column craft overview covering case finish, crystal clarity, and strap taper. Section 3: close-up dial and lug detail strip. Section 4: full technical specifications grid and clean minimal footer."
    }
  ],
  "settings": {
    "skill": "webpage",
    "resolution": "2k"
  }
}

Achte beim Schreiben langer Briefings auf das gewichtete Prompt-Limit. Kling Image 4.0 Long Image akzeptiert bis zu 166.000 englische Zeichen oder 71.000 nicht-englische Zeichen, wobei gemischtsprachige Texte durch english / 166000 + non_english / 71000 <= 1 begrenzt sind. Dieses Limit wird erneut geprüft, nachdem @id-Namen in Positionsmarker umgewandelt wurden; halte also eine kleine Sicherheitsreserve ein, wenn dein Prompt nahe an der Obergrenze liegt.[2]

Budgets über 1K, 2K und Längenstufen planen

Anders als herkömmliche Einzelbild-Generatoren, die pro ausgegebener Kachel abrechnen, berechnet Kling Image 4.0 Long Image jede abgeschlossene Anfrage als einen Ausgabestufen-Tarif zuzüglich einer Gebühr pro Eingabe-Referenzbild (einschließlich der ersten Referenz). Fehlgeschlagene Generierungen, die kein Ergebnis liefern, geben ihre reservierten Credits automatisch wieder frei.[2]

Die folgende Tabelle listet die aktuellen reAPI-Tarife mit Stand 20. November 2026 auf (1 Credit = 0,001 USD, 1 $ = 1.000 Credits). Prüfe vor großen Stapelläufen immer die aktiven Tarife auf der Preisseite für Kling Image 4.0 Long Image.[3]

StufeAuflösungreAPI-Tarif (Stand 20. Nov. 2026)Typische Verwendung
ecommerce · short1k / 2k0,2269 $ / 0,2723 $Kompakte Produktzusammenfassung mit 2–5 Abschnitten
ecommerce · medium1k / 2k0,4538 $ / 0,5294 $Standard-Shop-Detailseite mit 6–10 Abschnitten
ecommerce · long1k / 2k0,7563 $ / 0,8319 $Vollständige Flaggschiff-Angebotsseite mit 11–18 Abschnitten
webpage1k / 2k0,5294 $ / 0,5748 $Full-Scroll-Landingpage oder Kampagnen-Layout
Eingabe-ReferenzbildBeliebig0,003025 $ je BildEinmalig pro bereitgestelltem Referenzfoto berechnet

Ein konkretes Rechenbeispiel mit diesen Tarifen vom 20. November 2026: Eine ecommerce-medium-2k-Anfrage mit zwei Produktfotos ergibt insgesamt 0,5294 $ + 2 × 0,003025 $ = 0,53545 $. Bei Einreichung reserviert reAPI ceil(0.53545 × 1000) = 536 ganze Credits, rechnet bei Abschluss auf exakte Mikrodollar ab und bucht die Bruchteilsdifferenz wieder auf dein Guthaben zurück.[2]

Eine praktische Methode zur Kostenkontrolle bei Kling Image 4.0 Long Image ist ein zweistufiger Ablauf. Entwirf die Layout-Reihenfolge und den Abschnittstext in 1k (oder ecommerce short 1k, wenn du zuerst die Produkttreue prüfst), kontrolliere jedes Band und wechsle erst auf 2k, sobald die visuelle Abfolge feststeht.

Zuverlässig abfragen und hohe PNG-Ausgaben prüfen

Nach dem Absenden einer Anfrage an Kling Image 4.0 Long Image frage GET /api/v1/tasks/{id} in einem gleichmäßigen Intervall ab, etwa alle 5 bis 10 Sekunden, mit einem Client-Timeout-Budget von mindestens 15 bis 20 Minuten für long- + 2k-Jobs. Sende POST /v1/images/generations bei einem kurzen Aussetzer einer Abfrage nicht automatisch erneut; jeder neue POST erzeugt eine frische abrechenbare Aufgabe.[4]

Sobald status den Wert completed erreicht, lies die einzelne URL aus output.image_urls[0] aus und kopiere das PNG sofort in deinen eigenen Speicher. Da hohe 2K-Layouts über 50 MB groß sein und vertikal mehr als 15.000 Pixel umfassen können, streame Downloads direkt auf den Datenträger, statt ganze Dateien im knappen Speicher kleiner Serverless-Funktionen zu puffern, und prüfe das Ergebnis in zwei Durchgängen:

  1. Miniaturansicht in voller Höhe scannen: Zoome heraus, um visuellen Rhythmus, Farbkonsistenz von oben nach unten und klare Trennungen zwischen Abschnitten zu überprüfen.
  2. Abschnittsweise Prüfung bei 100 % Zoom: Kontrolliere die Hero-Überschrift, Produktsilhouetten, Materialoberflächen, Detailbeschriftungen und den unteren Spezifikationsblock in nativer Pixelgröße.

Nimm nur verifizierte Produktabmessungen, Garantiebedingungen und technische Spezifikationen in dein Briefing auf. Die Prüfung der Textgenauigkeit bei 100 % Zoom deckt verzerrte Ziffern oder fehlende Zeichen auf, bevor ein Layout ins Shop-Slicing oder in die Frontend-Entwicklung geht.

Häufig gestellte Fragen

Kann ich mit Kling Image 4.0 Long Image eine vertikale 4K-Seite generieren?

Nein. Kling Image 4.0 Long Image unterstützt ausschließlich Ausgaben in 1k (1024 px Breite) und 2k (2048 px Breite). Anfragen mit 4k werden noch vor der Reservierung von Credits mit einem Validierungsfehler abgelehnt. Für einzelne 4K-Standbilder oder Mehrfach-Aufnahmeserien nutze Kling Image 4.0.

Warum ist meine Ecommerce-Anfrage ohne Referenzen bei der Validierung fehlgeschlagen?

Der Ecommerce-Modus erfordert zwischen 1 und 3 refer_image-Elemente in contents, damit das Modell jeden vertikalen Abschnitt in echten Produktfotos verankern kann. Wenn du ein vertikales Layout allein aus Text generieren möchtest, setze settings.skill auf webpage.

Kann ich refer_image und style_refer_image in einer Anfrage kombinieren?

Nein. Referenzrollen sind strikt nach Modus getrennt: ecommerce akzeptiert nur refer_image, während webpage nur style_refer_image und subject_refer_image akzeptiert. Der Playground blockiert gemischte Rollen vor dem Absenden; bei direkten API-Aufrufen kann die Anfrage zunächst Credits reservieren, anschließend asynchron fehlschlagen und die reservierten Credits automatisch zurückerstatten.

Zählt das erste Referenzbild bereits für die Abrechnung?

Ja. Jedes in contents übergebene Eingabe-Referenzbild wird bei einer abgeschlossenen Aufgabe einmal berechnet, beginnend ab dem ersten Bild. Fehlgeschlagene Aufgaben ohne Ergebnis geben ihre reservierten Credits automatisch frei.

Wie unterscheidet sich Kling Image 4.0 Long Image von Kling Image 4.0?

Kling Image 4.0 Long Image gibt ein einzelnes durchgehendes hohes PNG aus, das auf vertikale Ecommerce-Detailseiten und Webpage-Layouts zugeschnitten ist. Kling Image 4.0 erzeugt Standbilder im Standard-Seitenverhältnis (bis zu 9 unabhängige Varianten oder eine Serie aus 2–10 Aufnahmen) in 2K oder 4K.

Wie sollte ich Downloads für 50 MB große hohe PNG-Ausgaben handhaben?

Setze HTTP-Download-Timeouts über 60 Sekunden, streame Antwort-Bytes direkt in den Objektspeicher oder auf den Datenträger und überprüfe nach dem Download Content-Length oder die PNG-Abmessungen, bevor du Bild-Slicing-Skripte ausführst.

Kling Image 4.0 Long Image produktiv einsetzen

Teste zunächst einen 1k-webpage-Prompt im Playground für Kling Image 4.0 Long Image, um Abschnittstempo und visuelle Balance zu prüfen. Sobald die vertikale Gliederung zu deiner Shop- oder Kampagnenstruktur passt, fixiere deine Referenz-URLs, folge dem Schema in der API-Dokumentation zu Kling Image 4.0 Long Image und baue eine wiederholbare Abfrage- und Slicing-Pipeline rund um output.image_urls[0].

Quellen

  1. Kling AI, Kling Image 4.0 Long Image Generation API — offizielle Spezifikationen der Skills ecommerce und webpage, Hinweise zu Längenstufen und Referenzlimits.
  2. reAPI, API-Dokumentation zu Kling Image 4.0 Long Image — Anfrageschema, HTTP(S)-Referenzeinschränkungen, gewichtete Prompt-Limits, Ausgabeschema und Abrechnungsmechanik.
  3. reAPI, Modellseite und Live-Preise für Kling Image 4.0 Long Image — aktuelle Tarife pro Ausgabestufe und pro Referenz, Stand 20. November 2026.
  4. reAPI, Tasks-API-Referenz — asynchrone Aufgabenabfrage, Endzustände und Fehlerbehandlung.

Weitere Beiträge

Alle Anleitungen