Zum Hauptinhalt springen
POST
Senden Sie mit model: "kling-v4-long-image" eine asynchrone Anfrage an POST /v1/images/generations. Lesen Sie data[0].task_id aus und fragen Sie GET /v1/tasks/{task_id} ab. Jede Anfrage liefert ein langes PNG; der Webseitenmodus erzeugt ein Bild des Seitendesigns.

Modus wählen

Authentifizierung

string
erforderlich
Verwenden Sie Authorization: Bearer <token>. <token> ist Ihr APIMart-API-Schlüssel.

Anfrageparameter

string
erforderlich
Muss kling-v4-long-image sein.
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Bildauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
string
erforderlich
Erforderlich und nicht nur Leerzeichen. Maximal 166.000 Zeichen bei rein englischem Text und 71.000 bei rein chinesischem Text und ähnlichen Sprachen; gemischte Texte werden anteilig berechnet. Beschreiben Sie Layout, Abschnitte, Texte, Stil und Motiv.
string
erforderlich
Erforderlich: ecommerce für Produktdetailseiten oder webpage für Webseitendesigns, unabhängig von Groß- und Kleinschreibung. Die Modi verwenden unterschiedliche Referenzfelder.
string
Standard:"medium"
Nur für skill: "ecommerce": short, medium (Standard) oder long, ungefähr 2–5, 6–10 bzw. 11–18 Inhaltsabschnitte. Inhalt und Höhe richten sich nach dem Ergebnis. Im Webseitenmodus muss das Feld fehlen, sonst folgt HTTP 400.
string
Standard:"1K"
Unterstützt 1K (Standard) und 2K, unabhängig von Groß- und Kleinschreibung. Beide gelten für alle E-Commerce-Längen, auch long + 2K. Die Ausgabebreite beträgt 1024 bzw. 2048 px; die Höhe hängt vom Inhalt ab. 4K wird nicht unterstützt.
string[]
Nur für E-Commerce: 1–3 Produktbilder erforderlich. Im Webseitenmodus weglassen und image_with_roles verwenden. Geben Sie öffentlich erreichbare direkte Bild-URLs an. Lokale Dateien können über die Bild-Upload-API hochgeladen werden; verwenden Sie anschließend die zurückgegebene url.
object[]
Optional, nur für Webseiten. Höchstens ein Bild mit style und eines mit subject; eine oder beide Rollen können entfallen. Im E-Commerce-Modus dieses Feld weglassen.
integer
Jede Anfrage erzeugt ein langes Bild. Weglassen oder die Ganzzahl 1 angeben; andere Werte führen zu HTTP 400.
boolean
Weglassen oder false angeben; true führt zu HTTP 400.
Senden Sie keine Felder size, aspect_ratio, width, height, mask_url, sequential_image_generation oder sequential_image_generation_options. Auch null oder eine leere Zeichenfolge führt bei diesen Feldern zu HTTP 400.

Anforderungen und Referenzmarkierungen

Unterstützt JPG / JPEG / PNG. Pro Bild höchstens 30 MB, beide Seiten mindestens 300 px, Seitenverhältnis von 2:5 bis 5:2. HTTP 403 / 404 / 410 der URL, unzulässige Maße oder Verhältnisse sowie zu große Dateien liefern synchron HTTP 400, ohne Aufgabe oder Generierungsgebühr. Andere Abruffehler wie ein Timeout des Ursprungsservers werden zunächst angenommen; die Aufgabe schlägt danach fehl und vorab abgezogene Gebühren werden erstattet. Nutzen Sie @Image1, @Image2 usw. im Prompt. E-Commerce folgt der Reihenfolge in image_urls, Webseiten der Reihenfolge Stil, dann Motiv. Bei nur einer Rolle ist deren Bild @Image1.

Anfragebeispiele

Senden Sie diese Anfragen an POST /v1/images/generations. Ersetzen Sie Beispiel-URLs durch erreichbare direkte Bildlinks.

Lange Produktseite in 2K

Webseite mit Stil- und Motivvorlage

Webseite nur aus einem Prompt

Aufgabe abfragen

Fragen Sie die Aufgaben-API etwa alle 10 Sekunden ab. Speichern Sie die task_id und vermeiden Sie auch bei längeren Wartezeiten doppelte Generierungsanfragen.
Das Beispiel zeigt die Struktur eines erfolgreichen Ergebnisses. images und url sind Arrays; dieses Modell liefert ein langes Bild pro Anfrage.
Laden Sie das Bild vor dem Unix-Zeitstempel in Sekunden unter data.result.images[0].expires_at herunter. Danach ist der Link ungültig.
Die Generierung dauert meist mehrere Minuten; ein Beispiel für long + 2K benötigte 432 Sekunden. estimated_time liefert derzeit immer 60 Sekunden und eignet sich nicht als Countdown oder Timeout-Grenze. Die Dauer hängt von Inhalt und Auslastung ab; der Messwert ist keine Obergrenze.Bildhöhe und Dateigröße hängen vom Inhalt ab. Ein Beispiel für long + 2K hatte 2048×46615 Pixel und 63,9 MB; das sind keine Ausgabegrenzen. Ergebnisse können 50 MB überschreiten. Berücksichtigen Sie den Aufwand für Download und Darstellung großer Bilder.

Abrechnung

Pro Anfrage wird ein langes Bild nach gewählter Ausgabestufe plus Referenzen berechnet: Preis der Ausgabestufe + Referenzanzahl × Referenzpreis. Produkt-, Stil- und Motivbilder zählen alle; auch das erste Referenzbild wird berechnet. Es gibt die folgenden 8 Ausgabestufen. Preisschlüssel: kling-v4-long-image@<Stufe>, für Referenzen kling-v4-long-image@input. Im Generierungsaufruf bleibt resolution auf 1K oder 2K beschränkt. Die Gebühr wird bei Einreichung vorab abgezogen, bei Erfolg abgerechnet und bei Fehler vollständig erstattet. Preise und Kontorabatte finden Sie auf der Preisseite.

Häufige Fehler

Diese Validierungsfehler liefern synchron HTTP 400, ohne Aufgabe oder Generierungsgebühr. Einreichungsfehler stehen in error.message, Fehler nach Erstellung in data.error.message.