Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, um den abschließenden Multimodal-Videobearbeitungsauftrag zu übermitteln, nachdem Ihre Session und Auswahlen bereit sind.

Vollständiger Workflow

1

Bearbeitungssitzung initialisieren

Beginnen Sie mit Video zur Bearbeitung initialisieren, um die session_id für den Clip zu erhalten, den Sie bearbeiten möchten.
2

Auswahlbereich erstellen

Verwenden Sie Videoauswahl hinzufügen und bei Bedarf Ausgewählten Videobereich in der Vorschau anzeigen, um den Bearbeitungsbereich zu verfeinern.
3

Abschließende Aufgabe übermitteln

Senden Sie die session_id, den edit_mode, den finalen prompt sowie alle optionalen Generierungseinstellungen über diesen Endpunkt und speichern Sie dann die zurückgegebene task id für Statusabfragen.

Bevor Sie ihn aufrufen

  • Stellen Sie sicher, dass die Auswahlsitzung bereits initialisiert ist
  • Bestätigen Sie, dass Ihre Regionsauswahl korrekt ist, bevor Sie einen Generierungsaufruf verbrauchen
  • Führen Sie Folgeaufrufe für die Auswahl mit demselben Konto und mit der exakt bei der Initialisierung zurückgegebenen session_id aus
  • Setzen Sie edit_mode auf addition, swap oder removal
  • Geben Sie image_list für addition und swap an; lassen Sie image_list für removal weg
  • Senden Sie duration als String wie "5" oder "10"; die Beispiele übergeben "5" explizit
  • Behandeln Sie diese Route als den abschließenden Generierungsschritt, nicht als den Einrichtungsschritt
  • Fügen Sie image_list, negative_prompt, mode, duration, callback_url oder external_task_id nur hinzu, wenn der Bearbeitungs-Workflow sie benötigt
Die vollständige Parameterreferenz finden Sie in der Kling API-Dokumentation.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Body

application/json
session_id
string
erforderlich

Selection session id returned by init-selection. Follow-up calls must use the same account and exact session id.

edit_mode
enum<string>
erforderlich

Editing operation for the selected video region. Use addition to add an element, swap to replace a selected element, or removal to remove it.

Verfügbare Optionen:
addition,
swap,
removal
prompt
string
erforderlich

Instruction describing the desired edit. Reference the source video as <<<video_1>>> and any reference image as <<<image_1>>>.

model_name
enum<string>
Standard:kling-v1-6

Kling model variant for the final edit task. Omit to use kling-v1-6.

Verfügbare Optionen:
kling-v1-6
image_list
object[]

Image references used by addition and swap tasks. Omit this field for removal tasks.

Minimum array length: 1
negative_prompt
string

Elements to avoid in the edited result.

mode
enum<string>

Generation mode. Use std or pro.

Verfügbare Optionen:
std,
pro
duration
string

Requested output duration in seconds.

callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

Antwort

200 - application/json

Task accepted.

code
integer
erforderlich
message
string
erforderlich
data
object
erforderlich