Skip to main content

Cosa realizzerai

Invierai un’attività Kling text-to-video, memorizzerai l’ID dell’attività restituito, interrogherai l’endpoint dell’attività Kling corrispondente e deciderai quando aggiungere callback_url per le notifiche push.

Prerequisiti

  • Una chiave API CometAPI archiviata in COMETAPI_KEY
  • Python 3.10+ con requests, oppure Node.js 18+
  • Un worker lato server per il polling oppure un endpoint di callback HTTPS per i webhook

Chiave API, URL di base, autenticazione

Crea un’attività Kling text-to-video con:
Verifica l’attività con:
Autenticati con un token Bearer:

Esempi di codice

Usa le schede qui sotto per esempi copiabili in cURL, Python e Node.js.

Spiegazione del flusso

La generazione video di Kling è asincrona. L’endpoint di creazione restituisce un data.task_id. Esegui il polling di GET /kling/v1/videos/text2video/<task_id> finché data.task_status non raggiunge succeed o failed. Quando l’attività va a buon fine, copia l’URL dell’asset completato da data.task_result nel tuo sistema di storage se ti serve un accesso duraturo. Aggiungi callback_url quando vuoi che gli aggiornamenti sullo stato dell’attività vengano inviati a un endpoint HTTPS sotto il tuo controllo. Mantieni comunque disponibile il polling per la riconciliazione e per eventuali callback non consegnate.

Parametri comuni

Risoluzione dei problemi / FAQ

Kling usa campi JSON specifici del provider come data.task_id, data.task_status e data.task_result. Non analizzarla come le route /v1/videos compatibili con OpenAI.
Usa un polling con limiti definiti e controlla data.task_status_msg quando un’attività fallisce. Salva il task ID per diagnostica successiva.
Usa il polling come base. Aggiungi callback_url per la consegna push, poi riconcilia lo stato finale con il polling.

Passi successivi