Skip to main content
POST
cURL
Utilisez ce endpoint pour soumettre le job final d’édition vidéo multimodale une fois que votre session et vos sélections sont prêtes.

Workflow complet

1

Initialiser la session d’édition

Commencez par Initialize Video for Editing pour obtenir le session_id du clip que vous souhaitez modifier.
2

Construire la zone de sélection

Utilisez Add Video Selection et, si nécessaire, Preview Selected Video Area pour affiner la région d’édition.
3

Soumettre la tâche finale

Envoyez le session_id, le edit_mode, le prompt final, ainsi que tous les paramètres de génération facultatifs via ce endpoint, puis enregistrez l’id de tâche renvoyé pour les vérifications de statut.

Avant de l’appeler

  • Assurez-vous que la session de sélection est déjà initialisée
  • Vérifiez que votre sélection de région est correcte avant de consommer un appel de génération
  • Exécutez les appels de suivi de sélection sur le même compte et avec le session_id exact renvoyé lors de l’initialisation
  • Définissez edit_mode sur addition, swap ou removal
  • Fournissez image_list pour addition et swap ; omettez image_list pour removal
  • Envoyez duration sous forme de chaîne comme "5" ou "10" ; les exemples transmettent explicitement "5"
  • Traitez cette route comme l’étape finale de génération, et non comme l’étape de configuration
  • Ajoutez image_list, negative_prompt, mode, duration, callback_url ou external_task_id uniquement lorsque le workflow d’édition en a besoin
Pour la référence complète des paramètres, consultez la documentation de l’API Kling.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json
session_id
string
requis

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

edit_mode
enum<string>
requis

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

Options disponibles:
addition,
swap,
removal
prompt
string
requis

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

model_name
enum<string>
défaut:kling-v1-6

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

Options disponibles:
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.

Options disponibles:
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.

Réponse

200 - application/json

Task accepted.

code
integer
requis
message
string
requis
data
object
requis