Kling 4.0 API

Vollständige API-Referenz für die Videogenerierungsmodelle Kling 4.0 von Kuaishou.

Modellvarianten

Diese API unterstützt fünf Modellvarianten:

Vergleich auf einen Blick

Unterstützte Seitenverhältnisse

Text-to-Video, Image-to-Video, Reference-to-Video und Video Edit unterstützen:

16:9, 9:16, 1:1, 21:9

Der Standardwert ist 16:9. Video Extend unterstützt den Parameter aspect_ratio nicht; die Ausgabe übernimmt das Seitenverhältnis des Quellvideos.

Auflösungsoptionen

Bei allen fünf Modellen sind resolution und duration erforderlich. Geben Sie resolution ausdrücklich an, auch wenn der Standardwert 720p ist. Für duration gibt es keinen Standardwert.

Kling 4.0 Text to Video

Endpunkt

POST /api/v1/video/task

Anfrageparameter

Erforderlich

Optional

Beispielanfrage

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-v4.0-text-to-video',
    prompt: 'A drone flying over a mountain range at sunrise, smooth forward camera movement',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Kling 4.0 Image to Video

Anfrageparameter

Erforderlich

Optional

Wenn sowohl image_url als auch image_end_url angegeben werden, darf key_frames höchstens 8 Bilder enthalten. Zwischenbilder werden in der Reihenfolge im Array verwendet; ihre zeitliche Position bestimmt das Modell.

Beispielanfrage

javascriptKopieren
{
  model_name: 'kling-v4.0-image-to-video',
  prompt: 'Camera slowly pulls back from the character to reveal the surrounding mountain landscape',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  key_frames: [
    'https://example.com/middle-frame-1.jpg',
    'https://example.com/middle-frame-2.jpg'
  ],
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Reference to Video

Anfrageparameter

Erforderlich

Optional

Referenzbilder, Referenzvideos und Referenzaudio sind alle optional. Geben Sie einen beliebigen Medientyp an, kombinieren Sie Medientypen oder lassen Sie alle drei weg.

Die Ausgabe-duration wird unabhängig auf 3–30 Sekunden festgelegt und zählt nicht zur maximalen Gesamtdauer der Referenzvideos.

Beispielanfrage

javascriptKopieren
{
  model_name: 'kling-v4.0-reference-to-video',
  prompt: 'Use the character from the reference image, follow the camera movement in the reference video, and use the reference audio for voice guidance',
  images: ['https://example.com/character-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  keep_original_sound: false,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Edit

Anfrageparameter

Erforderlich

Optional

Beispielanfrage

javascriptKopieren
{
  model_name: 'kling-v4.0-video-edit',
  prompt: 'Replace the background with warm sunset colors while preserving the subject and camera movement',
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/sunset-reference.jpg'],
  keep_original_sound: true,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Extend

Anfrageparameter

Erforderlich

Optional

Senden Sie aspect_ratio nicht mit; die Ausgabe übernimmt das Seitenverhältnis des Quellvideos. Das Ergebnis enthält das vollständige Video einschließlich Quellvideo und Verlängerung. Die Gesamtdauer entspricht der Dauer des Quellvideos plus duration.

Beispielanfrage

javascriptKopieren
{
  model_name: 'kling-v4.0-video-extend',
  prompt: 'Continue the camera movement forward through the valley as the sun rises above the mountains',
  video_url: 'https://example.com/source.mp4',
  image_end_url: 'https://example.com/target-end-frame.jpg',
  resolution: '720p',
  duration: 5
}

Abrechnungsregeln

Text-to-Video und Image-to-Video werden nach Ausgabeauflösung und Dauer des generierten Videos abgerechnet. Video Extend wird nach Auflösung und Dauer des zusätzlichen Segments abgerechnet, nicht nach der Gesamtdauer des zurückgegebenen Videos.

Bei Reference-to-Video-Anfragen mit Referenzvideos und bei Video Edit-Anfragen werden sowohl die Eingabe- als auch die Ausgabevideodauer bei der gewählten Auflösung berücksichtigt. Für die Eingabevideodauer werden mindestens 3 und höchstens 30 Sekunden abgerechnet. Bei mehreren Referenzvideos gelten diese Grenzen für ihre Gesamtdauer, nicht für jedes Video einzeln. Die Grenzen der Abrechnungsdauer legen keine Upload-Limits fest.

Ohne Referenzvideos gelten für Reference-to-Video dieselben Abrechnungsregeln wie für Text-to-Video, unabhängig davon, ob Referenzbilder oder Referenzaudio angegeben werden. Bei Anfragen mit Videoeingabe fallen für unterstützte Referenzbilder, Referenzaudio und keep_original_sound keine gesonderten Gebühren an.

Antwortformat

Erste Antwort

Alle Modelle geben eine task_id für die regelmäßige Statusabfrage zurück:

jsonKopieren
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Fragen Sie mit GET /api/v1/video/{task_id} regelmäßig den Status ab und rufen Sie das generierte Video ab.

Statuswerte

• submitted: Aufgabe angenommen und wartet auf Verarbeitung
• processing: Videogenerierung läuft
• succeed: Videogenerierung abgeschlossen
• failed: Videogenerierung fehlgeschlagen

Bewährte Vorgehensweisen

1. Erforderliche Parameter: Geben Sie immer resolution und duration an, auch bei Verwendung der Standardauflösung 720p
2. Bildanzahl: Beschränken Sie Startbild, Endbild und Zwischenbilder zusammen auf höchstens 10 Bilder
3. Referenzmedien: Halten Sie bei Referenzmedien die dokumentierten Anzahlen und Dauern ein
4. Originalton: Verwenden Sie keep_original_sound nur für Reference-to-Video oder Video Edit
5. Videoverlängerung: Setzen Sie duration auf die zusätzliche Dauer und lassen Sie aspect_ratio weg