Skip to main content
POST
cURL
Użyj tego endpointu, aby przesłać końcowe zadanie multimodalnej edycji wideo, gdy sesja i wybory są już gotowe.

Pełny workflow

1

Zainicjuj sesję edycji

Zacznij od Initialize Video for Editing, aby uzyskać session_id dla klipu, który chcesz edytować.
2

Zbuduj obszar zaznaczenia

Użyj Add Video Selection oraz, gdy to potrzebne, Preview Selected Video Area, aby dopracować obszar edycji.
3

Prześlij końcowe zadanie

Wyślij session_id, edit_mode, końcowy prompt oraz opcjonalne ustawienia generowania przez ten endpoint, a następnie zapisz zwrócony task id do sprawdzania statusu.

Przed wywołaniem

  • Upewnij się, że sesja zaznaczenia została już zainicjowana
  • Potwierdź, że wybór obszaru jest poprawny, zanim wykorzystasz wywołanie generowania
  • Uruchamiaj kolejne wywołania związane z zaznaczeniem na tym samym koncie i z dokładnie tym session_id, które zostało zwrócone podczas inicjalizacji
  • Ustaw edit_mode na addition, swap lub removal
  • Podaj image_list dla addition i swap; pomiń image_list dla removal
  • Wyślij duration jako ciąg znaków, np. "5" lub "10"; przykłady jawnie przekazują "5"
  • Traktuj ten route jako końcowy krok generowania, a nie krok konfiguracji
  • Dodawaj image_list, negative_prompt, mode, duration, callback_url lub external_task_id tylko wtedy, gdy workflow edycji ich wymaga
Aby zobaczyć pełne informacje referencyjne o parametrach, sprawdź dokumentację Kling API.

Autoryzacje

Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Treść

application/json
session_id
string
wymagane

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

edit_mode
enum<string>
wymagane

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

Dostępne opcje:
addition,
swap,
removal
prompt
string
wymagane

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

model_name
enum<string>
domyślnie:kling-v1-6

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

Dostępne opcje:
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.

Dostępne opcje:
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.

Odpowiedź

200 - application/json

Task accepted.

code
integer
wymagane
message
string
wymagane
data
object
wymagane