Kling 4.0-API-Dokumentation
Alles, was Sie benötigen, um Kling 4.0 aus Ihrem Code aufzurufen. Basis-URL: https://cheapergen.com/api/v1. Probieren Sie es zuerst in Playground aus.
Verwenden Sie einen Coding-Agenten?
Fügen Sie dies in Claude Code, Cursor, Codex oder einen beliebigen Coding-Agenten ein. Er bindet die API in Ihr Projekt ein, speichert den Schlüssel in CHEAPERGEN_API_KEY und prüft den Preis kostenlos, bevor Kosten entstehen.
Add Kling 4.0 (CheaperGen endpoint kuaishou/ kling-4.0/ text-to-video) to this project by following https:/ / cheapergen.com/ agents/ integrate.mdAuthentifizierung
Erstellen Sie in Dashboard → API keys einen Schlüssel und senden Sie ihn als Bearer-Token mit. Bewahren Sie Schlüssel ausschließlich auf Ihrem Server auf.
export CHEAPERGEN_API_KEY="cg_live_…"
# every request
Authorization: Bearer $CHEAPERGEN_API_KEYKling 4.0 Text zu Video-API
/api/v1/run/kuaishou/kling-4.0/text-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Nein |
aspect_ratio | string (enum) | Format des Ausgabebilds. Werte: 16:9 · 9:16 · 1:1 · 21:9 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. Werte: 720p · 1080p Standard: 720p | Ja |
duration | integer | Länge des generierten Clips in Sekunden (3–30 s). Abrechnung pro Sekunde. Bereich: 3–30s Standard: 5 | Ja |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Nein |
Anfrage
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/kuaishou/kling-4.0/text-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Ein Papierboot treibt nachts eine mit Regenwasser gefüllte Rinne entlang, Neonspiegelungen, sanftes Regenprasseln",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "kuaishou/kling-4.0",
"endpoint": "kuaishou/kling-4.0/text-to-video",
"mode": "text-to-video",
"status": "queued",
"input": {
"prompt": "Ein Papierboot treibt nachts eine mit Regenwasser gefüllte Rinne entlang, Neonspiegelungen, sanftes Regenprasseln",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Kling 4.0 Bild zu Video-API
/api/v1/run/kuaishou/kling-4.0/image-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Nein |
image_urlerforderlich | string (URL) | Bild für das erste Einzelbild. JPG/PNG/WebP, URL oder Upload. | Nein |
end_image_url | string (URL) | Optionales Schlussbild – das Modell animiert den Übergang zwischen beiden. | Nein |
resolution | string (enum) | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. Werte: 720p · 1080p Standard: 720p | Ja |
duration | integer | Länge des generierten Clips in Sekunden (3–30 s). Abrechnung pro Sekunde. Bereich: 3–30s Standard: 5 | Ja |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Nein |
Anfrage
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/kuaishou/kling-4.0/image-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Sie dreht sich zum Fenster und lächelt, während die Vorhänge im Wind wehen; langsame Kamerafahrt nach vorn",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"resolution": "720p",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "kuaishou/kling-4.0",
"endpoint": "kuaishou/kling-4.0/image-to-video",
"mode": "image-to-video",
"status": "queued",
"input": {
"prompt": "Sie dreht sich zum Fenster und lächelt, während die Vorhänge im Wind wehen; langsame Kamerafahrt nach vorn",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"resolution": "720p",
"duration": 5
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Kling 4.0 Referenz zu Video-API
/api/v1/run/kuaishou/kling-4.0/reference-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Nein |
reference_image_urls | string[] (URLs) | Bis zu 10 Bilder für Figuren, Produkte, Stil oder Szene. Verweisen Sie im Prompt mit @Image1, @Image2 usw. darauf. Maximale Anzahl: 10 | Nein |
reference_video_urls | string[] (video URLs) | Bis zu 5 MP4/MOV-Clips für Bewegung, Kamerafahrten oder Effekte (3–30 Sek. je, 30 s insgesamt, ≤ 200 MB je Datei). Verweisen Sie mit @Video1, @Video2 usw. darauf. Mit einem Referenzvideo werden die Ausgabesekunden plus die längere Dauer von Ausgabe und Referenzvideos zu einem niedrigeren Sekundentarif abgerechnet. Maximale Anzahl: 5 | Ja |
aspect_ratio | string (enum) | Format des Ausgabebilds. Werte: 16:9 · 9:16 · 1:1 · 21:9 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. Werte: 720p · 1080p Standard: 720p | Ja |
duration | integer | Länge des generierten Clips in Sekunden (3–30 s). Abrechnung pro Sekunde. Bereich: 3–30s Standard: 5 | Ja |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Nein |
Anfrage
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/kuaishou/kling-4.0/reference-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "@Image1 geht bei Sonnenuntergang am Strand entlang und übernimmt die Kamerabewegung von @Video1",
"reference_image_urls": [
"https://cdn.cheapergen.com/samples/reference-1.jpg"
],
"reference_video_urls": [
"https://cdn.cheapergen.com/samples/reference-1.mp4"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "kuaishou/kling-4.0",
"endpoint": "kuaishou/kling-4.0/reference-to-video",
"mode": "reference-to-video",
"status": "queued",
"input": {
"prompt": "@Image1 geht bei Sonnenuntergang am Strand entlang und übernimmt die Kamerabewegung von @Video1",
"reference_image_urls": [
"https://cdn.cheapergen.com/samples/reference-1.jpg"
],
"reference_video_urls": [
"https://cdn.cheapergen.com/samples/reference-1.mp4"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Ergebnis abrufen
Generierungen laufen asynchron. Fragen Sie den Status ab, bis status den Status succeeded, failed oder canceled erreicht – oder übergeben Sie webhook_url bereits beim Absenden. Fehlgeschlagene Generierungen werden automatisch erstattet.
curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"{
"status": "succeeded",
"output": {
"video": {
"url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
"content_type": "video/mp4"
}
}
}Mehr: Ablauf eines Auftrags · Webhooks · Fehler
Preise für Kling 4.0
Zahlen Sie pro Videosekunde nutzungsbasiert, ohne Abo (Monatstarife sind optional). Fehlgeschlagene Generierungen werden automatisch erstattet.
| Tarifstufe | Offizieller Preis | CheaperGen | Sie sparen |
|---|---|---|---|
720p Audio inklusive | $0,1486/s | −5% | |
1080p Audio inklusive | $0,2226/s | −5% |
- Offizieller Preis: Listenpreis der Kling-Entwickler-API für Kling 4.0, kling.ai/dev/pricing (1 Einheit = 0,157 $/s bei 720p, 1,5 Einheiten = 0,235 $/s bei 1080p; mit Videoeingabe 0,094 $ / 0,141 $ pro Sekunde Ausgabe plus der längeren Dauer von Ausgabe und Eingabevideo; Audio immer an). Preise geprüft am 18. Oktober 2026.
- Audio wird immer generiert und ist im Preis enthalten.
- Mit einem Referenzvideo werden die Ausgabesekunden plus die längere Dauer von Ausgabe und Referenzvideos zu einem niedrigeren Sekundentarif abgerechnet.