Image
Kling Image 4.0
Erstelle Bilder in 2K oder 4K mit Kling Image 4.0. Verwende benannte Referenzfotos, erstelle unabhängige Variationen oder eine zusammenhängende Serie und frage anschließend die fertigen Bild-URLs ab.
Sende eine JSON-Anfrage an POST /v1/images/generations mit der Modell-ID kling-image-4-0. Speichere die zurückgegebene Task-ID. Derselbe Endpunkt akzeptiert reine Textbeschreibungen und referenzgestützte Beschreibungen.
Schnellbeispiel
Diese Anfrage erstellt ein quadratisches Einzelbild in 2K. 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",
"contents": [
{"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
],
"settings": {"resolution": "2k", "aspect_ratio": "1:1"}
}'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 auf deinem Server auf.
Parameter
| Feld | Typ | Werte und Standardwerte |
|---|---|---|
model | Zeichenfolge, erforderlich | kling-image-4-0 |
contents | Array, erforderlich | Ein Prompt und null bis zehn Referenzbilder. |
contents[].type | Zeichenfolge, erforderlich | prompt oder refer_image. |
contents[].text | Zeichenfolge | Für den Prompt erforderlich. Englisch: höchstens 50.000 Zeichen, andere Sprachen: höchstens 21.000. Bei gemischtem Text dürfen die Anteile an den jeweiligen Höchstwerten zusammen höchstens eins ergeben. |
contents[].url | Zeichenfolge | Für jede Referenz erforderlich. Verwende eine öffentlich erreichbare HTTP(S)-URL zu einer JPEG- oder PNG-Datei mit höchstens 30 MB. Beide Seiten müssen mindestens 300 Pixel lang sein, und das Seitenverhältnis muss zwischen 2:5 und 5:2 liegen. |
contents[].id | Zeichenfolge | Optionaler eindeutiger Name für eine Referenz. Erwähne den Namen im Prompt als @name. |
settings.result_type | Zeichenfolge | single (Standard) für unabhängige Bilder oder series für zusammengehörige Bilder. |
settings.n | Ganzzahl | 1–9 unabhängige Bilder. Standardwert: 1. Wird nur im Einzelmodus verwendet. |
settings.series_amount | Ganzzahl oder Zeichenfolge | Im Serienmodus 2–10 Bilder, Standardwert: 4. Für 5–10 Bilder unterstützt der Prompt bis zu 20.000 Zeichen und muss jede Referenz namentlich erwähnen. Jede Referenz muss lesbar sein und darf höchstens 20 MB groß sein. Im Einzelmodus wird dieses Feld ignoriert; zulässig sind dann eine Ganzzahl von 2 bis 10 oder die Zeichenfolge auto. |
settings.resolution | Zeichenfolge | 2k (Standard) oder 4k. |
settings.aspect_ratio | Zeichenfolge | auto (Standard), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 oder 21:9. |
options.watermark_info.enabled | Boolescher Wert | Optional. Unterstützt wird nur false. |
Eine Serie anhand eines Referenzfotos
Ersetze die Beispiel-URL durch eine öffentlich erreichbare URL zu deinem Produktfoto. Dieses Beispiel fordert drei zusammenhängende Bilder an. Füge die Anweisung für jedes Bild in denselben Prompt ein.
{
"model": "kling-image-4-0",
"contents": [
{"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
{"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
],
"settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}Alle Bilder abrufen
Kopiere die id aus der POST-Antwort in TASK_ID. Frage diesen Endpunkt mit demselben Schlüssel so lange ab, bis der Task-Status completed oder failed lautet.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Lies nach Abschluss jede URL in output.data[].url aus. Ein Task kann mehrere Bilder zurückgeben. Wird eine Statusabfrage unterbrochen, rufe die ursprüngliche ID erneut ab. Informationen zum Lebenszyklus findest du in der Task-Referenz, Fehlercodes im Fehlerverzeichnis.
Preise
Die Gesamtkosten ergeben sich aus der Anzahl der Ausgabebilder in der angeforderten Auflösung multipliziert mit dem aktuellen Ausgabepreis, zuzüglich einer Gebühr pro Referenzbild. Vier 4K-Bilder mit zwei Referenzen kosten also vier 4K-Ausgabepreise und zwei Referenzgebühren. Für eine fehlgeschlagene Anfrage fallen keine Kosten an. Siehe die aktuellen Tarife.
Fehler und Tipps
Ungültige Eingaben führen zu einem Anfragefehler. Prüfe, ob Prompt-Text fehlt, Referenz-IDs doppelt vorkommen oder eine nicht unterstützte Auflösung beziehungsweise Serienkonfiguration angegeben ist. Wenn der erste Aufruf eine Task-ID zurückgegeben hat, frage diese ID ab, bevor du entscheidest, ob eine weitere Anfrage nötig ist.
Verwende bei einer Beschreibung mit mehreren Referenzen für jedes Motiv einen eigenen Namen und gib an, welche visuellen Merkmale die jeweilige Referenz beisteuert. Füge Kameravorgaben und die Abfolge der Aufnahmen in den Prompt ein. Siehe das Kling Image 4.0 Playground und das OpenAPI-Schema.
