Seedance 2.5 is live — 30-second cinematic video with native audio & real-person references
Kling API: Preise und Integrationsleitfaden
2026/09/03

Kling API: Preise und Integrationsleitfaden

Vergleiche aktuelle Kling-API-Preise, wähle Kling 3.0 oder Turbo, und implementiere Text-to-Video, Image-to-Video, Polling, Wiederholungen und Speicherung.

Der aktuelle reAPI-Preis für eine fünfsekündige Kling-API-Anfrage zur Text-zu-Video-Generierung beginnt bei 385 Credits ($0.385) mit kling-3-0, mode: "std" und ohne Sound. Die vollständige Kling-3.0-Route behandelt auch First-and-Last-Frame-Animation, natives Audio, strukturierte Multi-Shot-Prompts, wiederverwendbare Elemente und Ausgabe bis 4K. Kling 3.0 Turbo nutzt eine kleinere Anfrage-Oberfläche, sein Name bedeutet aber nicht, dass es die günstigste Option ist: Eine fünfsekündige Turbo-Anfrage in 720p kostet aktuell $0.630.[1][3]

Dieser Leitfaden behandelt den reAPI-Gateway-Vertrag vom ersten POST bis zum Polling und zur Dateispeicherung. Er zeigt auch, wo sich die offizielle Kling-Entwickler-API unterscheidet, damit Felder und Preise von einer Oberfläche nicht versehentlich in eine Anfrage zur anderen landen.

TL;DR

  • Für die günstigste Text-zu-Video-Generierung in der aktuellen Tabelle nutze kling-3-0 mit mode: "std", sound: false und einer expliziten Dauer.
  • Nutze kling-3-0 wenn du natives Audio, First- und Last-Frames, strukturierte Multi-Shot-Steuerung, Elemente oder 4K benötigst. Nutze kling-3-0-turbo nur, wenn sein einfacherer Text/First-Frame-Workflow genau das ist, was du evaluieren möchtest.
  • Reiche jeden reAPI-Kling-Video-Job bei POST /api/v1/videos/generations ein. Speichere die zurückgegebene id, dann frage GET /api/v1/tasks/{id} ab bis der Status completed oder failed ist.
  • Polling verbraucht keine Credits. Ein Zwei-bis-Drei-Sekunden-Rhythmus reicht; Antworten laufender Tasks werden fünf Sekunden lang gecacht.[6]
  • Lese usage.credits auf der abgeschlossenen Task. Die meisten Provider-, Timeout- und Persistierungs-Fehler werden zurückerstattet, aber einige Sicherheitsprüfungen nach der Generierung können eine Gebühr behalten.[6]
  • Kopiere ein fertiges Video in Speicher, den du kontrollierst. Der Task-Vertrag garantiert keine unbegrenzte CDN-Aufbewahrung.

Welches Kling-API-Modell solltest du verwenden?

Beginne mit dem Input, den du hast und der Kontrolle, die du brauchst. Motion Control ist kein billiger Ersatz für Text-zu-Video, und Turbo ist einfach keine günstigere Version des vollständigen Modells.

reAPI-Modell-IDErforderliche Anfrage-FelderWas die Route bietetSinnvolle erste Nutzung
kling-3-0Prompt oder strukturierte Shot-PromptsT2V; First/Last-Frame-I2V; natives Audio; bis zu fünf strukturierte Shots; Elemente; 720p, 1080p oder 4KDie meisten neuen Kling-Integrationen
kling-3-0-turboPrompt oder eine First-Frame-URLT2V und First-Frame-I2V; 720p oder 1080p; optionales WasserzeichenEin bewusst einfacher Turbo-Test
kling-v3-motion-controlprompt, image_url, video_url, character_orientation und modeMotion-Transfer in Standard oder ProNeuere, höherpreisige Motion-Control-Stufe
kling-v2-6-motion-controlprompt, image_url, video_url, character_orientation und modeDieselbe Anfrage-Form wie v3Günstigere Motion-Control-Validierung

Klings eigener Leitfaden beschreibt die breitere VIDEO-3.0-Familie als Unterstützung von drei bis fünfzehnsekündigen Ausgaben, Text-zu-Video, Image-zu-Video, Start- und End-Frames, natives Audio, Multi-Shot-Erzählungen und Element-Referenzen.[8] Die akzeptierten Felder hängen immer noch von der API-Oberfläche ab. Auf reAPI sind die Felder des vollständigen Modells unter kling-3-0 dokumentiert, während Turbo ein anderes Schema unter kling-3-0-turbo hat.

Motion Control verdient seinen eigenen Workflow, weil das Fahrvideo die Bewegung und die abrechenbare Dauer liefert. Der bestehende Kling Motion Control API-Leitfaden behandelt Orientierung, Quellvideo-Vorbereitung und Identity-Drift im Detail.

Kling-API-Preise ab 3. September 2026

reAPI rechnet die öffentlichen Kling-Routen pro Sekunde ab und rechnet die Anfrage in ganzen Credits ab. Ein Credit kostet $0.001. Die Preise für vollständiges Modell und Turbo unten wurden gegen gültige Payloads im Live-Rechner am 3. September 2026 überprüft; überprüfe die verlinkte Modellseite vor einem großen Batch erneut, da sich die Tarife ändern können.[1][3]

Kling 3.0 und Kling 3.0 Turbo Preise

Modell und StufeAudioTarif pro Sekunde5 Sekunden10 Sekunden15 Sekunden
kling-3-0 Standard (std)Aus$0.077$0.385$0.770$1.155
kling-3-0 Standard (std)An$0.110$0.550$1.100$1.650
kling-3-0 Pro (pro)Aus$0.099$0.495$0.990$1.485
kling-3-0 Pro (pro)An$0.1485$0.743$1.485$2.228
kling-3-0 4K (4K)Aus oder An$0.3685$1.843$3.685$5.528
kling-3-0-turbo 720pNicht verfügbar$0.12584$0.630$1.259$1.888
kling-3-0-turbo 1080pNicht verfügbar$0.15752$0.788$1.576$2.363

Die Dollar-Summen zeigen die Abrechnung mit ganzen Credits. Zum Beispiel werden fünf Sekunden Kling 3.0 Pro mit Sound wie folgt berechnet:

ceil($0.1485 × 5 Sekunden × 1.000 Credits pro Dollar)
= ceil(742,5)
= 743 Credits
= $0.743

Die Rundung erfolgt einmal für die Anfrage, nicht einmal pro Sekunde. Im strukturierten Multi-Shot-Modus ersetze die Dauer auf der obersten Ebene durch die Summe der Shot-Dauern. Ein viersekündiger Shot gefolgt von einem fünfsekündigen Shot wird also als neun Sekunden abgerechnet.[2]

Motion Control Preise

Diese Tarife sind eingeschlossen, damit ein Modellwähler alle vier öffentlichen IDs vergleichen kann. Die vom Server ermittelte Dauer des Quellvideos wird aufgerundet; es gibt kein duration-Feld, das der Client liefert. Die Tarife pro Sekunde stammen aus der Live-Motion-Control-Modellseite. Die 5-, 10- und 15-Sekunden-Summen sind berechnete Szenarien für Quellvideos, deren ermittelte abrechenbare Längen diesen Werten entsprechen, keine Payloads mit einem duration-Parameter.[11]

ModellModusTarif pro abrechenbarer Sekunde5 Sekunden10 Sekunden15 Sekunden
kling-v2-6-motion-controlStandard$0.062832$0.315$0.629$0.943
kling-v2-6-motion-controlPro$0.100584$0.503$1.006$1.509
kling-v3-motion-controlStandard$0.113168$0.566$1.132$1.698
kling-v3-motion-controlPro$0.150832$0.755$1.509$2.263

Ein fünfzehnsekündiges Quellvideo ist nur gültig, wenn Motion Control character_orientation: "video" nutzt; Bildorientierung begrenzt den Fahrvideo auf zehn Sekunden.[5]

Verwechsle reAPI-Credits nicht mit offiziellen API-Preisen und Consumer-Credits

Drei verschiedene Zahlenwerte mit dem Wort „Credit" können unterschiedliche Produkte beschreiben. Sie sind nicht austauschbar:

  1. reAPI-Credits rechnen Gateway-Anfragen zu je $0.001 ab. Das sind die Credits, die in den obigen Tabellen verwendet werden.
  2. Offizielle Kling-Entwickler-API-Preise gehören zur direkten API von Kuaishou, die sein eigenes Konto, seinen Anfrage-Vertrag und seinen Tarif hat.
  3. Consumer-Kling-Credits gehören zum Web- oder App-Abo. Sie können eine reAPI-Anfrage oder eine offizielle Entwickler-API-Anfrage nicht bezahlen.

Zum Kontext: Die offizielle Tarifkarte der Entwickler-API listete am 3. September die volle Kling 3.0 mit $0.084/$0.126 pro Sekunde für 720p ohne/mit natives Audio, $0.112/$0.168 für 1080p und $0.420 für 4K auf beide Arten auf.[10] Das sind offizielle Direkt-API-Listenpreise, keine Belege dafür, dass Kuaishou seine Preise an die reAPI-Tabelle angepasst hat. Wenn du eine reAPI-Integration budgetierst, nutze den reAPI-Tarif, der der genauen Modell-ID und Payload entspricht, die du einreichst.

Bevor du die erste Anfrage sendest

Du brauchst einen reAPI-Schlüssel und für Image-zu-Video Medien, die auf einer öffentlichen URL gehostet sind. Erstelle einen Schlüssel auf der API-Schlüssel-Seite, speichere ihn in einer Umgebungsvariablen und gib ihn niemals in Browser-Code oder ein öffentliches Repository.

Alle vier öffentlichen Kling-IDs nutzen denselben Einreiche-Endpunkt:

POST https://reapi.ai/api/v1/videos/generations
GET  https://reapi.ai/api/v1/tasks/{id}

Anfragen nutzen ein Bearer-Token:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Die Schemas sind streng. Ein Feld, das von einer anderen Video-API kopiert wurde, wird abgelehnt statt stillschweigend ignoriert. Medieneingaben müssen öffentliche HTTP(S)-URLs sein; lokale Pfade, data: URIs und Base64-Strings werden von diesen Routes nicht akzeptiert.

Felder, die kling-3-0 akzeptiert

FeldErforderlich?Akzeptierter Wert
modelJaGenauer Wert kling-3-0
promptNur Single-Shot1–2.500 Zeichen
image_urlsNeinBis zu zwei öffentliche HTTP(S) URLs: First Frame, dann optionaler Last Frame
soundNeinBoolean; Standardwert false
durationNeinGanze Zahl von 3 bis 15; Standardwert 5
aspect_ratioNein16:9, 9:16 oder 1:1; Standardwert 16:9
modeNeinstd, pro oder 4K; Standardwert pro
multi_shotsNeinBoolean; Standardwert false
multi_promptWenn multi_shots true istEin bis fünf { prompt, duration } Objekte
kling_elementsNeinBis zu drei Element-Objekte, jeweils mit zwei bis vier Referenz-URLs

Das Objekt ist streng, einschließlich seiner verschachtelten Shot- und Element-Objekte. Achte auf genaue Rechtschreibung: Das Audio-Feld heißt sound, das Stufen-Feld heißt mode, und das 4K-Enum nutzt einen Großbuchstaben K.[2]

Kling-API-Async-Workflow vom Einreichen einer Anfrage bis zum Speichern der Task-ID, Polling eines terminalen Status und Speicherung des Videos

Reiche eine fünfsekündige Kling-Text-zu-Video-Anfrage ein

Das ist die kostengünstigste fünfsekündige Text-zu-Video-Kombination in der aktuellen reAPI-Kling-Tabelle: Standard-Auflösung und kein Audio.

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0",
    "prompt": "A ceramic coffee cup on a wooden table as morning light moves slowly across the surface, locked camera, natural shadows",
    "duration": 5,
    "aspect_ratio": "16:9",
    "mode": "std",
    "sound": false
  }'

Eine erfolgreiche Einreichung gibt einen Task-Datensatz zurück, nicht das Video:

{
  "id": "task_018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e",
  "model": "kling-3-0",
  "status": "processing",
  "created_at": 1735000000
}

Das zu speichernde Feld ist id. Schreibe keinen Client-Code, der auf task_id wartet; dieser Schlüssel ist nicht in der von der API gezeigten Response-Umschlag enthalten.

Poll sicher, behandle Fehler und speichere das Video

Der komplette Ablauf ist ein POST gefolgt von begrenzten GET-Anfragen. Der POST bleibt außerhalb der Polling-Schleife. Dieses Detail ist wichtig: Eine erneute Einreichung kann ein anderes Video erstellen und berechnen, während eine erneute Task-Abfrage nur die bestehende Aufgabe liest.

Das folgende Skript wird auf Node.js 20 oder neuer ausgeführt. Es reicht eine fünfsekündige Anfrage ein, fragt alle drei Sekunden ab, versucht sichere Task-Ablesungen nach Ratenlimit oder temporären Gateway-Fehlern erneut und schreibt das abgeschlossene MP4 in das aktuelle Verzeichnis.

import { writeFile } from 'node:fs/promises';

const API_BASE = 'https://reapi.ai/api/v1';
const API_KEY = process.env.REAPI_API_KEY;
const OUTPUT_FILE = 'kling-output.mp4';

if (!API_KEY) throw new Error('Set REAPI_API_KEY before running this script');

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function parseResponse(response) {
  const body = await response.json().catch(() => ({}));
  if (response.ok) return body;

  const code = body.error?.code ?? response.status;
  const message = body.error?.message ?? response.statusText;
  const error = new Error(`${code}: ${message}`);
  error.status = response.status;
  error.retryAfter = response.headers.get('retry-after');
  throw error;
}

async function submitVideo() {
  const response = await fetch(`${API_BASE}/videos/generations`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'kling-3-0',
      prompt:
        'A ceramic coffee cup on a wooden table as morning light moves slowly across the surface, locked camera, natural shadows',
      duration: 5,
      aspect_ratio: '16:9',
      mode: 'std',
      sound: false,
    }),
  });

  // Intentionally no automatic POST retry: an uncertain response could hide
  // a task that was already created.
  return parseResponse(response);
}

async function readTask(taskId) {
  for (let attempt = 0; attempt < 5; attempt += 1) {
    try {
      const response = await fetch(`${API_BASE}/tasks/${taskId}`, {
        headers: { Authorization: `Bearer ${API_KEY}` },
      });
      return await parseResponse(response);
    } catch (error) {
      const retryable =
        error.status === 429 || [502, 503, 504].includes(error.status);
      if (!retryable || attempt === 4) throw error;

      const retryAfterSeconds = Number(error.retryAfter);
      const delay =
        error.status === 429 && Number.isFinite(retryAfterSeconds)
          ? retryAfterSeconds * 1000
          : Math.min(2 ** attempt * 1000, 8000);
      await sleep(delay);
    }
  }
}

async function waitForVideo(taskId) {
  const deadline = Date.now() + 30 * 60 * 1000;

  while (Date.now() < deadline) {
    await sleep(3000);
    const task = await readTask(taskId);

    if (task.status === 'completed') {
      const videoUrl = task.output?.video_urls?.[0];
      if (!videoUrl) throw new Error('Task completed without a video URL');
      return { videoUrl, credits: task.usage?.credits };
    }

    if (task.status === 'failed') {
      const code = task.error?.code ?? 'UNKNOWN_TASK_ERROR';
      const message = task.error?.message ?? 'Video generation failed';
      const credits = task.usage?.credits ?? 'unknown';
      throw new Error(`${code}: ${message}; settled credits: ${credits}`);
    }
  }

  throw new Error(`Client polling deadline reached for ${taskId}`);
}

async function downloadVideo(url) {
  const response = await fetch(url);
  if (!response.ok) {
    throw new Error(`Video download failed with HTTP ${response.status}`);
  }
  await writeFile(OUTPUT_FILE, Buffer.from(await response.arrayBuffer()));
}

const submitted = await submitVideo();
console.log(`Submitted ${submitted.id}`);

const result = await waitForVideo(submitted.id);
await downloadVideo(result.videoUrl);
console.log(`Saved ${OUTPUT_FILE}; settled credits: ${result.credits}`);

Die dreißig-Minuten-Frist gehört zu diesem Beispiel, nicht zum API-Vertrag. Video-Tasks können Minuten dauern, und die dokumentierte Wanduhr-Obergrenze des Workers ist 48 Stunden. Wähle ein Client-Timeout, das zu deinem Produkt passt, speichere die Task-ID persistent und lasse einen Background-Worker das Polling fortsetzen statt eine Web-Anfrage offenzuhalten.[6]

Das MP4 lokal zu schreiben beweist, dass der Download funktioniert. In der Produktion streame die Response in S3, R2 oder einen anderen Object Store und speichere deine dauerhafte URL neben der Task-ID. Tu das, sobald die Task fertig ist; der reAPI-Task-Vertrag garantiert keine permanente Aufbewahrung für erzeugte URLs.

Wandle ein Bild – oder First- und Last-Frames – in Video um

Die vollständige Kling-3.0-Route wechselt zu Image-zu-Video wenn image_urls vorhanden ist. Die erste URL ist der öffnende Frame; die optionale zweite URL ist der End-Frame. Ein Single-Shot-Prompt bleibt erforderlich.

{
  "model": "kling-3-0",
  "prompt": "The camera moves gently toward the bottle while the reflected light travels from left to right; preserve the label and bottle shape",
  "image_urls": [
    "https://assets.example.com/bottle-start.png",
    "https://assets.example.com/bottle-end.png"
  ],
  "duration": 6,
  "mode": "pro",
  "sound": false
}

Die Source-Frames bestimmen die Output-Proportionen, also ist aspect_ratio hier nicht nötig. Halte beide Bilder bei demselben Seitenverhältnis und nutze einen End-Frame, der eine plausible Fortsetzung darstellt. Eine drastische Änderung des Kamerawinkels, der Beleuchtung und der Objekt-Geometrie gibt dem Modell mehrere Konflikte auf einmal zu lösen.

Wenn du nur einen First-Frame brauchst, übergib eine URL. Für einen breiteren Vergleich von First-Frame-, First-and-Last-Frame- und Reference-Image-Workflows siehe den Image-to-Video-API-Leitfaden.

Füge natives Audio und strukturierte Multi-Shot-Steuerung hinzu

kling-3-0 stellt Audio mit dem sound Boolean bereit. Der strukturierte Multi-Shot-Modus ersetzt den einzelnen Top-Level-Prompt mit bis zu fünf Prompt-und-Dauer-Objekten. Jeder Shot-Prompt akzeptiert 1–500 Zeichen und jede Shot-Dauer muss eine ganze Zahl von 1 bis 12 Sekunden sein.[2]

{
  "model": "kling-3-0",
  "aspect_ratio": "16:9",
  "mode": "pro",
  "sound": true,
  "multi_shots": true,
  "multi_prompt": [
    {
      "prompt": "Close shot of a barista placing a cup on the counter; soft room tone and a quiet ceramic tap",
      "duration": 4
    },
    {
      "prompt": "Cut to a wider view as morning customers enter; the room ambience continues naturally",
      "duration": 5
    }
  ]
}

Diese Anfrage rechnet neun Pro-mit-Audio-Sekunden ab: 1.337 Credits oder $1.337 zum für diesen Artikel überprüften Tarif. Es gibt keine Notwendigkeit, eine Top-Level-duration für die Preisberechnung hinzuzufügen; die zwei Shot-Dauern sind der abrechenbare Gesamtwert.

Für ein wiederkehrendes Motiv oder Produkt akzeptiert die gleiche vollständige Route bis zu drei kling_elements. Jedes Element braucht einen Namen und zwei bis vier Referenzbild-URLs und kann eine Beschreibung enthalten. Referenziere es im Prompt als @name:

{
  "model": "kling-3-0",
  "prompt": "Slow orbit around @bluebottle on a stone pedestal; keep the cap, glass shape, and front label unchanged",
  "kling_elements": [
    {
      "name": "bluebottle",
      "description": "A rectangular cobalt-blue perfume bottle",
      "element_input_urls": [
        "https://assets.example.com/bottle-front.png",
        "https://assets.example.com/bottle-side.png"
      ]
    }
  ],
  "duration": 5,
  "mode": "pro"
}

Ein Element ist Referenzevidenz, keine Garantie dafür, dass jedes kleine Label oder jede Oberfläche bei Bewegung erhalten bleibt. Überprüfe Identität, Text, Geometrie und Reflexionen separat, bevor du einen Batch genehmigst.

Wann Kling 3.0 Turbo die richtige Anfrage ist

Das reAPI-Schema von Turbo ist absichtlich kleiner. Es unterstützt Text-zu-Video oder Animation von einem First-Frame mit 720p/1080p-Auflösung und optionalem Wasserzeichen. Es stellt nicht die sound, Last-Frame-, multi_prompt, kling_elements oder 4K Felder von vollständigem Kling 3.0 bereit.[4]

FeldErforderlich?Akzeptierter Wert
modelJaGenauer Wert kling-3-0-turbo
promptNur T2V1–3.072 Zeichen; optional wenn ein First-Frame vorhanden ist
first_frame_imageNeinEine öffentliche HTTP(S) Bild-URL
resolutionNein720p oder 1080p; Standardwert 720p
durationNeinGanze Zahl von 3 bis 15; Standardwert 5
aspect_ratioNein16:9, 9:16 oder 1:1; Nur T2V
watermarkNeinBoolean

Eine First-Frame-Anfrage sieht so aus:

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0-turbo",
    "prompt": "The dog looks toward the sea as wind moves its fur; gentle handheld camera",
    "first_frame_image": "https://assets.example.com/dog-on-beach.jpg",
    "resolution": "720p",
    "duration": 5,
    "watermark": false
  }'

Wenn first_frame_image vorhanden ist, bestimmt das Quellbild das Seitenverhältnis und der prompt kann weggelassen werden. Für Text-zu-Video ist der Prompt erforderlich und aspect_ratio akzeptiert 16:9, 9:16 oder 1:1.

Das Wort „Turbo" ist leicht zu überlesen. Am überprüften Datum kostete 720p Turbo $0.12584 pro Sekunde, mehr als vollständiges Kling 3.0 Standard ohne Audio bei $0.077 und Pro ohne Audio bei $0.099. Dieser Artikel enthält keine kontrollierte Latenz- oder Output-Qualitäts-Benchmark, also wähle Turbo für seine Route und beobachtete Ergebnisse auf deiner Last – nicht weil das Label einen Preisvorteil andeutet.

Behandle Validierung, Wiederholungen und Rückerstattungen ohne doppelte Jobs

Trenne Fehler, die eine geänderte Anfrage brauchen von Fehlern, die einen weiteren Leseversuch rechtfertigen. Der Fehler-Katalog nutzt einen numerischen Code in einer standard { error: { code, message, request_id } } Umschlag.[7]

ErgebnisWas es normalerweise bedeutetNächste Aktion
HTTP 400, Code 2xxxxFehlendes Feld, ungültiges Enum/Bereich, zusätzliches Feld oder nicht unterstütztes ModellKorrigiere die Payload; versuche nicht erneut ohne Änderung
HTTP 401/403Fehlende, ungültige, widerrufene oder nicht zulässige AnmeldeinformationBehebe Authentifizierung oder Origin
HTTP 402, Code 30001Unzureichende CreditsFüge Credits hinzu oder reduziere die Anfrage
HTTP 404, Code 40001 beim PollingTask fehlt oder gehört zu einem anderen BenutzerÜberprüfe Task-ID und API-Schlüssel
HTTP 429, Code 50001RatenlimitWarte auf Retry-After, dann versuche erneut
HTTP 502/503/504Temporäres Upstream- oder Service-VerfügbarkeitsproblemVersuche sichere Lesevorgänge erneut mit Backoff
HTTP 200 mit status: "failed"Der asynchrone Job erreichte einen terminalen FehlerInspiziere error.code, error.message und usage.credits

Task-Fehler erscheinen in einer erfolgreichen HTTP 200 Polling-Response. Codes im 8xxxx-Bereich unterscheiden Einreichungsfehler, Workflow-Timeout, terminalen Upstream-Fehler, fehlende Output-URLs, Persistierungs-Fehler, Content-Policy-Fehler, ungültige Upstream-Eingabe und Abbruch.[7]

Das Rückerstattungsverhalten ist ebenso spezifisch. Provider-Fehler, Timeouts und Persistierungs-Fehler werden erstattet, wenn der Workflow endet. Einige modellspezifische Richtlinien nach der Generierung können Ausgabe verbergen und trotzdem eine Gebühr behalten. Auf einer fehlgeschlagenen Task bedeutet usage.credits: 0 dass die Reservierung vollständig erstattet wurde; ein positiver Wert ist der beibehaltene Betrag.[6]

Versuche den POST nicht automatisch erneut, wenn das Netzwerk nach dem Senden des Body ausfällt. Die dokumentierte reAPI-Oberfläche stellt keinen Idempotency-Schlüssel für diese Einreichung bereit, also existiert der ursprüngliche Job möglicherweise bereits. Protokolliere die request_id, Task-ID wenn verfügbar, Zeitstempel, Modell und Payload-Hash. Automatische Wiederholungen werden besser für Task-GETs und andere idempotente Lesevorgänge reserviert.

Offizielle Kling-API-Felder sind nicht reAPI-Felder

Die Modellfamilie ist dieselbe, aber die zwei APIs sind separate Produkte. Offizielle Kling-Beispiele nutzen https://api-singapore.klingai.com, modalitätsspezifische Pfade wie /text-to-video/kling-3.0, verschachtelte settings und options und eine Task-Abfrage bei /tasks?task_ids=....[9] Seine Image-zu-Video-Anfrage nutzt einen separaten Pfad und contents Struktur.[12] reAPI nutzt einen Video-Generierungs-Pfad und wählt die Route aus dem flachen model Feld.

ThemaOffizielle Kling-Entwickler-APIreAPI-Gateway
AnmeldeinformationOffizieller Kling-API-SchlüsselreAPI-API-Schlüssel
Einreiche-PfadSeparate T2V/I2V-Modell-PfadePOST /api/v1/videos/generations
Anfrage-FormVerschachtelte settings, options und I2V contentsFlaches modellspezifisches JSON
Task-Abfrage/tasks?task_ids=.../api/v1/tasks/{id}
Success-Vokabularsubmitted, processing, succeeded, failedprocessing, completed, failed
Preis-QuelleOffizielle Kling-Entwickler-TarifkartereAPI-Modellseite und Rechner

Diese Unterscheidung erklärt mehrere häufige Integrationsfehler. Eine offizielle Payload mit settings.resolution ist auf dem strikten reAPI-Schema nicht gültig. Ein reAPI-Client, der auf succeeded wartet, wartet auch über ein gültiges completed Ergebnis hinaus. Wähle einen Vertrag, nutze seinen Schlüssel, Felder, Status-Namen und Preis-Quelle von Anfang bis Ende.

Produktions-Checkliste

Bevor du einen Kling-Workflow in eine Queue sendest, überprüfe die Teile, die später schwer zu rekonstruieren sind:

  • Fixiere die genaue öffentliche Modell-ID und notiere das Preis-Überprüfungs-Datum.
  • Validiere Dauer, Auflösung oder Modus, Seitenverhältnis, Audio und Shot-Anzahl vor der Einreichung.
  • Stelle sicher, dass jede Media-URL abrufbar ist ohne Cookies, ablaufende Browser-Sitzungen oder lokalen Netzwerk-Zugriff.
  • Speichere die zurückgegebene id persistently vor dem Polling.
  • Poll in einem Background-Job mit einer Frist und respektiere Retry-After.
  • Behandle completed und failed als terminal; notiere usage.credits für beide.
  • Kopiere abgeschlossene Dateien zu dauerhafter Speicherung und speichere die finale Speicher-URL.
  • Protokolliere request_id für Einreichungsfehler und die verschachtelte Task-Fehler für asynchrone Ausfälle.
  • Überprüfe visuelle Akzeptanz separat von API-Fertigstellung. Ein abgeschlossener Clip kann immer noch für dein Produkt unbrauchbar sein.

Dieser letzte Punkt ändert echte Unit-Ökonomik. Die API-Tabelle gibt Kosten pro abgeschlossener Anfrage an. Ein Produktions-Budget sollte gesamter abgerechneter Ausgaben / akzeptierte Clips nutzen, einschließlich abgeschlossener Generierungen, die deine visuelle Überprüfung nicht bestehen. Für eine breitere Erklärung von gemischten Abrechnungseinheiten und Akzeptanzkosten, siehe AI-Video-Generierungs-API-Preisgestaltung.

FAQ

Wie viel kostet die Kling API für fünf Sekunden?

Auf reAPI am 3. September 2026 reichte fünfsekündiges Text-zu-Video von $0.385 für vollständiges Kling 3.0 Standard ohne Sound bis $1.843 für 4K. Turbo kostete $0.630 bei 720p und $0.788 bei 1080p. Überprüfe die Live-Modellseite vor der Einreichung, da Tarife sich ändern können.

Ist Kling 3.0 Turbo billiger als Kling 3.0?

Nicht in der überprüften reAPI-Tabelle. Turbo 720p war $0.12584 pro Sekunde, während vollständiges Kling 3.0 Standard ohne Sound $0.077 und Pro ohne Sound $0.099 war. Wähle Turbo für seine spezifische Route und Output-Verhalten, nicht seinen Namen.

Kann die Kling API sowohl einen First- als auch einen Last-Frame animieren?

Ja, mit kling-3-0 auf reAPI. Setze den First-Frame auf Index 0 und den optionalen Last-Frame auf Index 1 von image_urls. Turbo akzeptiert nur ein first_frame_image.

Erzeugt Kling 3.0 Audio?

Die vollständige kling-3-0 Route stellt natives Audio durch sound: true bereit. Standard- und Pro-Audio-Anfragen haben höhere aktuelle Tarife pro Sekunde als ihre stillen Versionen. Das reAPI-Turbo-Schema stellt kein sound Feld bereit.

Wie oft sollte ich eine Kling-Video-Task abfragen?

Alle zwei bis drei Sekunden ist ein vernünftiger Start-Rhythmus. Häufigeres Polling macht die Generierung nicht schneller fertig, und Antworten laufender Tasks werden fünf Sekunden lang gecacht. Nutze einen Background-Worker und eine Client-seitige Frist.

Werden fehlgeschlagene Kling-API-Jobs abgerechnet?

Lese die abgeschlossene Task statt anzunehmen. Auf reAPI bedeutet failed mit usage.credits: 0 dass die Reservierung vollständig erstattet wurde. Ein positiver Wert bedeutet eine dokumentierte modellspezifische Gebühr wurde behalten, die nach bestimmten Sicherheitsentscheidungen nach der Generierung auftreten kann.

Kann ich Base64-Bilder an diese reAPI-Kling-Routes senden?

Nein. Das Gateway akzeptiert öffentliche HTTP(S)-Media-URLs für diese Felder. Lade das Bild zuerst in Speicher hoch, dann reiche seine URL ein.

Fazit

Ein zuverlässiger Kling-API-Preis- und Integrations-Plan beginnt mit der genauen Route, nicht dem Modellfamiliennamen. Für eine neue Text-zu-Video-Entwicklung ist vollständiges Kling 3.0 Standard ohne Sound der aktuell günstigste Start-Punkt; füge Pro, Audio, strukturierte Shots, Last-Frames oder 4K nur hinzu, wenn Ausgabe sie verlangt. Reiche einmal ein, speichere die Response-id, frage die Task mit einer Frist ab, inspiziere die abgerechneten Credits und verschiebe jedes akzeptierte Video in Speicher, den du kontrollierst.

Die Kling-3.0-Modellseite und Turbo-Modellseite führen die aktuellen reAPI-Preise. Halte die Tasks-API und Fehler-Referenz neben dem Code bereit, während du die erste Produktions-Queue verdrahtst.

Referenzen

  1. reAPI Kling 3.0 model and live pricing page, accessed September 3, 2026.
  2. reAPI Kling 3.0 API documentation, accessed September 3, 2026.
  3. reAPI Kling 3.0 Turbo model and live pricing page, accessed September 3, 2026.
  4. reAPI Kling 3.0 Turbo API documentation, accessed September 3, 2026.
  5. reAPI Kling Motion Control API documentation, accessed September 3, 2026.
  6. reAPI Tasks API reference, accessed September 3, 2026.
  7. reAPI error-code reference, accessed September 3, 2026.
  8. Kling VIDEO 3.0 Model User Guide, Kuaishou, February 6, 2026; accessed September 3, 2026.
  9. Kling AI Open Platform: VIDEO 3.0 text-to-video API, accessed September 3, 2026.
  10. Kling AI Open Platform video-generation pricing, accessed September 3, 2026.
  11. reAPI Kling Motion Control model and live pricing page, accessed September 3, 2026.
  12. Kling AI Open Platform: VIDEO 3.0 image-to-video API, accessed September 3, 2026.