Kling V4 Flash

APIMaster-Vertrag für kling-v4-flash, geprüft am 2026-11-07. Kanal 317 unterstützt Text, Startbild, Referenzen, Bearbeitung und Verlängerung. Nur 720p, 24 fps, 3–20 Sekunden; eigenständiges Modell neben Kling V4.

Kling V4 Flash

Endpunkte und Authentifizierung

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

Parameter

JSON und Authorization: Bearer YOUR_API_KEY verwenden. model muss kling-v4-flash sein. prompt ist außer bei einem Startbild erforderlich. duration/seconds: ganze JSON-Zahlen 3–20, Standard 5; null bedeutet weggelassen, 0 ist ungültig. Beide Angaben müssen gültig und gleich sein. Bearbeitung ohne duration nutzt die aufgerundete Videospurdauer. resolution nur 720p. aspect_ratio bzw. size: 16:9, 9:16, 1:1, 21:9; auto nur bei Referenzen. Text standardmäßig 16:9, Referenzen auto, Bearbeitung übernimmt sonst die Quelle. Startbild und Verlängerung erlauben keine nichtleeren aspect_ratio/size. audio nur true, watermark nur false.

Parameter	JSON-Typ	Pflicht	Standard	Bedeutung und Grenzen
model	string	Ja	kling-v4-flash	Immer kling-v4-flash für alle fünf Vorgänge; kling-v4 ist ein anderes Modell.
prompt	string	Je Modus	—	Szene, Bewegung oder Änderung beschreiben. Nur bei einem Startbild optional. @Image1 und @Video1 zählen je Medienarray getrennt ab 1; das bearbeitete Video ist @Video1.
duration	integer / null	Nein	5	JSON-Ganzzahl 3–20 Sekunden, gewöhnlich 5. Bearbeitung ohne beide Zeitfelder rundet die Videospurdauer der Quelle auf; Verlängerung bezeichnet den NEUEN Abschnitt. null bedeutet ausgelassen; 0, Nicht-Ganzzahlen und Zahlenstrings werden abgelehnt.
seconds	integer / null	Nein	—	Alias von duration mit denselben Grenzen. Möglichst nur eines senden; bei beiden müssen gültige Werte übereinstimmen, sonst 400.
resolution	string	Nein	720p	Nur 720p. Qualitätsstufe, keine Garantie einer kurzen Kante von 720px. 1080p und Qualitätswahl über mode werden nicht unterstützt.
aspect_ratio	string	Nein	Je Modus	Text/Referenz/Bearbeitung: 16:9, 9:16, 1:1, 21:9; auto nur für Referenzen. Standard: Text 16:9, Referenz auto, Bearbeitung wie Quelle. Bei Startbild/Verlängerung nichtleere Werte verboten; leere Zeichenfolge gilt als ausgelassen.
size	string	Nein	—	Alias für aspect_ratio, keine Auflösung oder Pixelgröße. Bei gemeinsamer Angabe müssen Werte gleich sein. Für Startbild und Verlängerung beide weglassen.
image_urls	string[]	Je Modus	—	Öffentliche Bild-URLs. Auto nimmt genau ein Startbild; reine Bildreferenzen benötigen explizit reference. Referenz/Bearbeitung: höchstens 10 Bilder einschließlich reference_image-Einträgen. Startbild-Darstellungen nicht mischen; Verlängerung akzeptiert keine Bilder.
first_frame_image	string	Je Modus	—	Öffentliche URL des einzigen Startbilds, alternativ zu einem image_urls-Eintrag oder first_frame-Rolle. Jede Bildkante ≥300px, Verhältnis 2:5–5:2; bei Bedarf vorher zuschneiden.
image_with_roles	{url, role}[]	Je Modus	—	Jedes Objekt benötigt öffentliche url und role. first_frame für das einzige Startbild, reference_image für Referenz/Bearbeitung. Keine End-/Zwischen-/Schlüsselbilder. Insgesamt ≤10 Referenzbilder und ≤15 Bild-/Videoreferenzen.
video_url	string	Je Modus	—	Eine öffentliche Quellvideo-URL nur mit explizitem edit/extend, nicht gemeinsam mit video_urls. Bearbeitung: MP4/MOV, Videospur 3–20s, beide Kanten jeweils 700–4553px. Verlängerung beginnt am letzten Bild und liefert nur den neuen Abschnitt; keine Aufgaben-/Dialog-ID.
video_urls	string[]	Je Modus	—	Bis zu 5 MP4/MOV-Referenzen, jede Videospur ≥3s, jede Kante 700–4553px, Summe ≤20s. Explizite edit/extend können genau einen Eintrag statt video_url nutzen. Überlänge wird abgelehnt, nicht abgeschnitten; das Array wählt automatisch Referenzmodus.
omni_reference_task_type	string	Nein	auto	auto erkennt Text/Startbild/Referenzen; reference benötigt Referenzmaterial; edit/extend benötigen genau ein Video. video_url ohne expliziten Modus und zwei normale Bilder in auto sind ungültig.
audio_setting	string	Nein	auto	Nur Referenzmodus MIT VIDEO. auto erzeugt neuen Ton; origin übernimmt den Ton des ERSTEN Videos, ohne dessen Tonspur bleibt auch die Ausgabe ohne Tonspur. Bei Bearbeitung, Verlängerung, Text oder reinen Bildreferenzen weglassen.
audio	boolean	Nein	true	Kompatibilitäts-Boolean: auslassen oder true; false wird abgelehnt. Originalton wird über audio_setting geregelt. Separate Audioreferenzen werden nicht unterstützt.
watermark	boolean	Nein	false	Kompatibilitäts-Boolean: auslassen oder false; true wird abgelehnt. Kein Dienst zur Entfernung von Wasserzeichen aus Quellen.

Direkte öffentliche HTTP(S)-URLs ohne eingebettete Zugangsdaten; kein base64/lokaler Pfad/Aufgaben-ID. Bildformate und Byte-Limits werden nicht gesondert zugesichert. 100MiB ist das Leselimit je geprüftem Referenz-/Bearbeitungsvideo, kein allgemeines Uploadlimit.

Modi und Medien

Vorgang	Auswahl und erforderliche Medien	Standard und Ausschlüsse
Text zu Video	Keine Medien, prompt erforderlich, Typ auto oder ausgelassen.	5s, 16:9; kein audio_setting.
Startbild zu Video	Ein Bild über EINE der drei Darstellungen; prompt optional.	5s, Bildverhältnis; kein aspect_ratio/size oder Endbild.
Referenz zu Video	reference + Bilder, reference_image-Rollen oder video_urls; prompt erforderlich.	5s, auto; Bilder≤10, Videos≤5, insgesamt≤15; Toneinstellung nur mit Video.
Videobearbeitung	edit + ein Video, prompt erforderlich; bis 10 Referenzbilder.	Quelldauer aufgerundet, Verhältnis der Quelle; keine Bildrollen/audio_setting.
Videoverlängerung	extend + ein Video, prompt erforderlich.	5 NEUE Sekunden; keine Bilder, Verhältnisänderung/audio_setting; Mindestgröße/-dauer von edit/reference gilt nicht.

omni_reference_task_type: auto, reference, edit, extend. Ein image_urls-Bild, first_frame_image oder die Rolle first_frame bestimmt das Startbild. Mehrere Referenzbilder erfordern reference oder reference_image; zwei image_urls in auto werden abgelehnt. video_urls wählt Referenzen, sofern edit/extend nicht gesetzt ist. video_url erfordert edit/extend und schließt video_urls aus. Bearbeitung/Verlängerung benötigen ein Video. Bearbeitung darf Bilder ergänzen; Verlängerung akzeptiert keine Bilder/audio_setting und liefert nur den neuen Abschnitt. Fortsetzung über die öffentliche Video-URL, nicht über Aufgaben- oder Gesprächs-IDs.

Direkte öffentliche HTTP(S)-URLs ohne eingebettete Zugangsdaten. Höchstens 10 Bilder, insgesamt 15 Bild-/Videoreferenzen. Bilder mindestens 300×300 Pixel, Verhältnis 2:5–5:2. Höchstens 5 MP4/MOV-Referenzen, jeweils mindestens 3 Sekunden, zusammen höchstens 20; Bearbeitung: ein Video mit 3–20 Sekunden. Breite UND Höhe jeweils 700–4553 Pixel. Der Gateway liest höchstens 100 MiB je geprüftem Video und misst die Videospur, nicht Container/Audio. Diese Mindestdauer-/Größenprüfungen gelten nicht für Verlängerungsquellen. Der Anbieter prüft Bilder zusätzlich. audio_setting=origin übernimmt Audio der ersten Videoreferenz oder Stille, auto erzeugt Audio; nur für Referenzen MIT Video. Bearbeitung erzeugt Audio neu. Keine Audio-URLs, End-/Zwischenbilder, Keyframes, negative_prompt, mode, seed, Mehrfachszenen oder Stimmen-/Figurenlisten.

Ausgabepixel und Bildrate

Verhältnis / Vorgang	Dokumentierte Ausgabepixel	Bildrate
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
Startbild zu Video	Bildverhältnis, etwa 0,92MP; z. B. 604×1516 bei 2:5.	24 fps

Ausgabegröße ist keine Eingabeanforderung. 21:9 ist 628px hoch und unterschreitet die 700px für Referenz/Bearbeitung: geeignete Quelle vorbereiten. Für Verlängerung gilt dieser Mindestwert nicht. Die Datei kann etwa ein Bild länger sein.

Nicht ausführbare Beispiele

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

Abrechnung

Offizielle nominale Basis: $0.094 je Ausgabesekunde (720P), $0.0628 je Abrechnungssekunde mit Video (720P-input). Text, Bilder, Referenzen ohne Video und Verlängerung: Ausgabe/neuer Abschnitt. Videoreferenzen und Bearbeitung: Ausgabe + max(Eingabe, Ausgabe). Alle Eingabe-Videospuren zuerst summieren, danach die Summe auf volle Sekunden aufrunden. 3.04 Sekunden Eingabe und 3 Ausgabe ergeben 3+max(4,3)=7 Abrechnungssekunden. Ein zusätzlicher Frame ändert die angeforderte ganzzahlige Ausgabedauer nicht. Paketnachlässe und Kontofaktoren sind separat; maßgeblich sind Modellkarte und Schlussbetrag im Protokoll. Bestätigte Generierungsfehler erstatten die Reservierung. Abfrageende storniert nichts; unklare Netzwerk-Timeouts rechtfertigen keine neue Generierung.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

Abfrage, Fehler und sichere Wiederholung

Erste Annahme: HTTP 200, öffentliche task_id, queued. GET /v1/videos/{task_id}: queued/in_progress/completed/failed, vorübergehend unknown möglich. url und metadata.url benötigen Bearer; alternativ GET /v1/videos/{task_id}/content. Generierungsfehler: error.code=generation_failed und bereinigte Meldung; Parameterfehler: HTTP 400. Idempotency-Key: 8–128 sichtbare ASCII-Zeichen ohne Leerzeichen. Gleiches Konto/Schlüssel/Anfrage: HTTP 202 ohne neue Generierung/Reservierung, Änderungen: 409. GET /v1/video-submissions/by-key liest den Beleg. accepted+task_ready=true: task_id abfragen; pending/submitting oder nicht bereit: warten. Bei acceptance_unknown Schlüssel sichern und Support kontaktieren, nicht automatisch neu senden. 404 beweist keine Nichtannahme. Mindestens 30 Tage Aufbewahrung; Schutz im Gateway, keine Anbietersuche. Schlussbetrag im Verbrauchsprotokoll nach other.task_id; Taskabfrage garantiert keine Rechnung. /v1/videos/quote nicht unterstützt. Beispiele sind inaktiv; URLs ersetzen, neuer Schlüssel je neuer Operation.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI