Zum Hauptinhalt springen
POST
Senden Sie mit model: "kling-v4-image" eine asynchrone Anfrage an POST /v1/images/generations. Lesen Sie data[0].task_id aus und fragen Sie das Ergebnis über GET /v1/tasks/{task_id} ab.

Authentifizierung

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

Anfrageparameter

string
erforderlich
Muss kling-v4-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
Für Text-zu-Bild, Bild-zu-Bild und Serien erforderlich. Beschreiben Sie gewünschte und unerwünschte Inhalte im Prompt. Die Grenze beträgt 50.000 Zeichen für rein englischen Text und 21.000 für rein chinesischen Text und ähnliche Sprachen; bei gemischten Sprachen wird sie anteilig berechnet.
string[]
Bis zu 10 Referenzbilder als öffentlich zugängliche direkte Bild-URLs. Lokale Dateien können Sie über die Bild-Upload-API hochladen und anschließend die zurückgegebene url verwenden.Unterstützt JPG / JPEG / PNG / GIF. Pro Bild höchstens 30 MB, Breite und Höhe jeweils mindestens 300 px und Seitenverhältnis zwischen 2:5 und 5:2.Referenzbilder werden bei der Einreichung geprüft. Bei HTTP 403 / 404 / 410 der URL, einer Seite unter 300 px, einem Verhältnis außerhalb von 2:5–5:2 oder mehr als 30 MB wird sofort HTTP 400 zurückgegeben. Es wird keine Aufgabe erstellt und keine Generierungsgebühr berechnet. Andere Abruffehler, etwa ein Timeout des Ursprungsservers, werden zunächst angenommen; anschließend schlägt die Aufgabe fehl und vorab abgezogene Generierungsgebühren werden vollständig erstattet.Mit @Image1, @Image2 usw. verweisen Sie im Prompt auf die Reihenfolge im Array. Die Bilder werden auch ohne diese Markierungen als Referenz verwendet.
integer
Standard:"1"
Anzahl der Ausgabebilder im Standardmodus: ganze Zahl von 1 bis 9, Standard 1. Im Serienmodus kann n entfallen oder 1 sein; die Ausgabeanzahl wird durch sequential_image_generation_options.max_images bestimmt. n > 1 im Serienmodus führt zu HTTP 400.
string
Standard:"2K"
Unterstützt 2K (Standard), 4K und 8K, unabhängig von Groß- und Kleinschreibung. Ausgabe als PNG. Bei 1:1 entspricht 2K 2048×2048, 4K 4096×4096 und 8K 8192×8192. Bei anderen Verhältnissen gelten die tatsächlichen Maße der zurückgegebenen Bilder.8K unterstützt Text-zu-Bild, Bild-zu-Bild und Serien: 1–9 Ausgaben im Standardmodus, 2–4 Bilder pro Serie und bis zu 10 Referenzbilder. Format- und Größenanforderungen sowie die Grenze von 30 MB pro Referenzbild bleiben unverändert.
string
Standard:"auto"
Seitenverhältnis der Ausgabe. Unterstützt auto (Standard) sowie diese 8 festen Verhältnisse:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.auto wählt das Verhältnis anhand des Prompts oder der Referenzbilder. Pixelmaße wie 2048x2048 werden nicht unterstützt.
string
Alias für size mit denselben Werten. Werden beide angegeben, hat aspect_ratio Vorrang.
string
Standard:"disabled"
disabled oder Weglassen aktiviert die normale Generierung. Mit auto wird eine Serie zusammengehöriger Bilder erzeugt; dann ist sequential_image_generation_options.max_images erforderlich. auto bestimmt hier nicht automatisch die Bildanzahl.
object
Legt die Bildanzahl im Serienmodus fest.
width, height, mask_url, Pixelmaße in size und watermark: true werden nicht unterstützt und führen zu HTTP 400.

Anfragebeispiele

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

Bild-zu-Bild

Drei 4K-Bilder erzeugen

Ein 8K-Bild erzeugen

Eine Serie aus vier zusammengehörigen 8K-Bildern erzeugen

Setzen Sie max_images auf 2–4. n kann im Serienmodus entfallen oder 1 sein, darf aber nicht größer als 1 sein. Serien können mehrere Minuten dauern. Speichern Sie die task_id und fragen Sie den Status ab, statt die Anfrage erneut einzureichen.

8K-Ausgaben und gemessene Bearbeitungszeiten

Die folgenden Beispiele wurden in der Testumgebung gemessen. Abmessungen, Dateigrößen und Bearbeitungszeiten dienen als Anhaltspunkte; tatsächliche Ergebnisse können abweichen. Fragen Sie den Status alle 5–10 Sekunden ab, bis er completed oder failed lautet. estimated_time ist auf 60 Sekunden festgelegt und eignet sich nicht als tatsächliche Zeitschätzung oder Countdown. Bewahren Sie die task_id auf und senden Sie während der Wartezeit keine doppelten Anfragen. 8K-Ergebnisse sind PNG-Originale; eine einzelne Datei kann größer als 100 MB sein. Verwenden Sie für Listen und Vorschauen selbst erzeugte Vorschaubilder oder laden Sie Bilder erst bei Bedarf. Bieten Sie einen Download des Originals an und weisen Sie auf die große Datei hin.

Aufgabe abfragen

Lesen Sie data.status über die Aufgabenabfrage-API: pending / processing bedeutet laufend, completed erfolgreich und failed fehlgeschlagen. Fehlerdetails stehen in data.error.message.
Das folgende Beispiel zeigt die Struktur eines erfolgreichen Ergebnisses. Bild-URLs stehen in data.result.images[].url[]; url ist ein Array. Lesen Sie alle Ausgaben aus und laden Sie sie zeitnah herunter.

Abrechnung

Abgerechnet werden die tatsächlich erzeugten Bilder nach der gewählten Auflösungsstufe. Referenzbilder werden separat pro Bild berechnet. Aktuelle Preise finden Sie auf der Preisseite.
  • Bei normaler Generierung mit n=3 werden 3 Ausgabebilder berechnet; bei Serien zählt die tatsächlich zurückgegebene Anzahl.
  • Jedes Referenzbild wird pro Anfrage einmal berechnet, unabhängig von der Ausgabeanzahl. 3 Bilder aus 2 Referenzen entsprechen 2 Eingabe- und 3 Ausgabebildern.
  • Fehlgeschlagene Generierungsaufgaben werden nicht berechnet; vorab abgezogene Generierungsgebühren werden vollständig erstattet.

Häufige Parameterfehler

Diese Parameterfehler liefern bei der Einreichung synchron HTTP 400. Es wird keine Aufgabe erstellt und keine Generierungsgebühr berechnet. Lesen Sie error.message bei Einreichungsfehlern und data.error.message bei Fehlern nach der Aufgabenerstellung.