Kling 3.0 Turbo

Mit Kling 3.0 Turbo 3–15 Sekunden lange Clips mit Ton aus einem Prompt oder einem ersten Frame erzeugen, in 720p oder 1080p, pro Sekunde abgerechnet und als Aufgabe geliefert.

Kling 3.0 Turbo ist ein Videomodell aus Kuaishous Kling 3.0 Familie. Eine Anfrage erzeugt einen 3–15 Sekunden langen Clip mit Ton aus einem Prompt oder aus einem Prompt plus einem ersten Frame, in 720p oder 1080p. Sende die Anfrage, behalte die zurückgegebene Aufgaben-ID und lies das fertige Video aus der Aufgabe. Bilder werden als URLs übergeben.

Modell-IDs

Modell-ID	Eingaben	Auflösungen	Länge
`kling-3-0-turbo`	Text, erster Frame	`720p`, `1080p`	3–15 Sekunden

Aktuelle Preise findest du auf der Modellseite.

Kurzbeispiel

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0-turbo",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Endpunkt

POST https://api.seedrouter.ai/v1/videos/generations

Header	Wert
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

Die Antwort ist eine Aufgabe ({"id": "task_...", "status": "processing"}), nicht das fertige Video. Frag GET /v1/tasks/{task_id} ab, um das Ergebnis zu erhalten. Bewahre API-Schlüssel im serverseitigen Code auf.

Parameter

Feld	Typ	Standardwert	Hinweise
`model`	string	Pflicht	`kling-3-0-turbo`
`prompt`	string	Pflicht	Bis zu 3.072 Zeichen, mit erstem Frame 2.500. Auch mit erstem Frame Pflicht.
`first_frame_image`	URL	keiner	Der erste Frame des Clips. Ohne ihn ist der Clip Text zu Video.
`resolution`	enum	`720p`	`720p` oder `1080p`.
`duration`	integer	`5`	3–15 Sekunden.
`aspect_ratio`	enum	`16:9`	`16:9`, `9:16` oder `1:1`. Nur bei Text zu Video: Mit einem ersten Frame bestimmt der Frame das Format.
`watermark`	boolean	keiner	`true` fügt ein Wasserzeichen hinzu. Fehlt das Feld, hat der Clip keines.

Jeder Clip kommt mit Ton; eine Ton-Einstellung gibt es nicht. Das Schema ist strikt: Unbekannte Felder werden abgelehnt statt ignoriert. callback_url ist nicht verfügbar; frag stattdessen die Aufgabe ab.

Bild zu Video

Übergib einen ersten Frame in first_frame_image und beschreibe in prompt, was als Nächstes passiert. Der Clip beginnt mit dem Frame und übernimmt sein Format, daher wird aspect_ratio nicht verwendet.

{
  "model": "kling-3-0-turbo",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze.",
  "first_frame_image": "https://example.com/frame.png",
  "resolution": "1080p",
  "duration": 5
}

Medieneingaben

Der erste Frame ist eine öffentliche HTTP(S)-URL. Base64-Data-URIs werden nicht akzeptiert: Lade die Datei in deinen eigenen Speicher hoch und übergib ihre URL. Verwende ein JPG- oder PNG-Bild mit höchstens 10 MB.

Kostenfaktoren

Aktuelle Tarife findest du im Preisbereich der Modellseite. Kling 3.0 Turbo wird pro Sekunde Video abgerechnet, zu einem Tarif, den die Auflösung bestimmt:

cost = duration × rate per second for the resolution

Die Dauer steht fest, wenn die Anfrage angenommen wird, daher ist der reservierte Betrag auch der berechnete Betrag. Die endgültigen Kosten siehst du im Nutzungsverlauf deines Kontos. Fehlgeschlagene Aufgaben werden nicht berechnet.

Ausgabeschema

Beim Senden wird die Aufgabe zurückgegeben:

{"id": "task_...", "model": "kling-3-0-turbo", "status": "processing", "created_at": 1789689600}

Aufgabe abrufen

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Frag alle 10–20 Sekunden ab, bis status den Wert completed oder failed hat. Eine Zeitüberschreitung des Netzwerks während der Abfrage bedeutet nicht, dass die Erzeugung fehlgeschlagen ist: Behalte die Aufgaben-ID und setze die Prüfung fort. Erstelle keine weitere Aufgabe, um den Fortschritt zu prüfen.

Abgeschlossene Aufgabe

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

In unseren Tests kamen 3-Sekunden-Clips in 720p als MP4 (H.264) mit 1280 × 720 und 5-Sekunden-Clips in 1080p mit 1920 × 1080 zurück, alle mit Stereo-Audiospur, zwischen 54 Sekunden und etwa 5 Minuten 20 Sekunden nach dem Absenden.

Fehler

Anfragen, die vor der Erstellung einer Aufgabe abgelehnt werden, geben einen HTTP-Fehler mit einem error-Objekt zurück und werden nicht berechnet. Eine Aufgabe, die nach der Annahme fehlschlägt, gibt bei der Abfrage HTTP 200 zurück, zusammen mit status: "failed" und einem error-Objekt.

Codes, HTTP-Status und Hinweise zu Wiederholungen findest du im gemeinsamen Fehlerkatalog.

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Kommt es beim Senden selbst zu einer Zeitüberschreitung, prüfe deine Aufgaben, bevor du erneut sendest: Die erste Anfrage wurde möglicherweise bereits angenommen.

Tipps

Beschreibe Motiv, Ort, Kamerabewegung und Licht in je einem Satz; Kamerasprache wie "slow push-in" und "low angle" wird befolgt.
Erstelle Entwürfe in 720p und rendere die finale Einstellung dann mit derselben Anfrage in 1080p.
Beschreibe mit einem ersten Frame nur, was sich bewegt: Der Frame legt die Szene bereits fest.
Füge no text, no logos hinzu, um erfundene Zeichen fernzuhalten.