Kling 3.0

Kling 3.0 ist das Videogenerierungsmodell von Kuaishou. Eine Anfrage erzeugt einen 3–15 Sekunden langen Clip aus einem Prompt oder aus einem ersten Frame und einem optionalen letzten Frame, in drei Qualitätsmodi (std, pro, 4K), auf Wunsch mit nativem Ton. Ein Clip kann auch eine Folge von bis zu fünf Einstellungen sein, jede mit eigenem Prompt und eigener Länge. Sende die Anfrage, behalte die zurückgegebene Aufgaben-ID und lies das fertige Video aus der Aufgabe. Bilder werden als URLs übergeben.

Modell-IDs

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",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Endpunkt

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

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

Das Schema ist strikt: Unbekannte Felder werden abgelehnt statt ignoriert. callback_url ist nicht verfügbar; frag stattdessen die Aufgabe ab.

Multi-Shot-Clips

Setze multi_shots auf true und beschreibe jede Einstellung in multi_prompt. Die Dauern der Einstellungen müssen zusammen 3–15 Sekunden ergeben; diese Summe ist die Cliplänge, und duration wird nicht verwendet. prompt kann weggelassen oder für das genutzt werden, was alle Einstellungen gemeinsam haben.

{
  "model": "kling-3-0",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "A red paper boat on a calm pond at sunrise, wide shot", "duration": 3},
    {"prompt": "The boat drifts under a small wooden bridge, low angle", "duration": 3}
  ]
}

Elemente

Ein Element ist ein Motiv, das das Modell über den ganzen Clip gleich hält: eine Person, ein Produkt oder eine Figur. Gib ihm einen name, eine kurze description und 2–4 Bilder davon und nenne es im Prompt beim Namen (zum Beispiel @hero).

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

Medieneingaben

Jedes Bild 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 JPG- oder PNG-Bilder mit höchstens 10 MB.

Kostenfaktoren

Aktuelle Tarife findest du im Preisbereich der Modellseite. Kling 3.0 wird pro Sekunde Video abgerechnet, zu einem Tarif, den der Modus und ein aktiviertes sound bestimmen:

billed seconds = duration                      (single shot)
billed seconds = Σ multi_prompt[].duration     (multi_shots: true)
cost = billed seconds × rate per second

Die abgerechneten Sekunden stehen 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", "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",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

In unseren Tests kam ein 3-Sekunden-Clip in std als MP4 (H.264) mit 1280 × 720 zurück und ein 5-Sekunden-Clip in pro mit sound in 1920 × 1080 samt Audiospur, jeweils nach etwa zwei bis drei Minuten.

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",
  "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; Kling folgt Kamerasprache wie "slow push-in" und "low angle".
• Erstelle Entwürfe in std und rendere die finale Einstellung dann mit derselben Anfrage in pro oder 4K.
• Nutze einen ersten und einen letzten Frame, um festzulegen, wo eine Einstellung beginnt und endet.
• Teile eine Szene mit multi_prompt in Einstellungen auf, statt mehrere Schnitte in einem Prompt zu beschreiben.
• Füge no text, no logos hinzu, um erfundene Zeichen fernzuhalten.

Weiterführend

• Playground und Preise für Kling 3.0
• OpenAPI herunterladen
• Markdown zum Kopieren