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 aggiungerecallback_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: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 undata.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
La struttura della risposta è diversa dalle route video di OpenAI
La struttura della risposta è diversa dalle route video di OpenAI
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.L'attività non raggiunge mai succeed
L'attività non raggiunge mai succeed
Usa un polling con limiti definiti e controlla
data.task_status_msg quando un’attività fallisce. Salva il task ID per diagnostica successiva.Dovrei usare callback_url o il polling
Dovrei usare callback_url o il polling
Usa il polling come base. Aggiungi
callback_url per la consegna push, poi riconcilia lo stato finale con il polling.Passi successivi
- Leggi il riferimento API text-to-video di Kling.
- Esegui il polling con Ottieni un’attività Kling.
- Configura i callback con Usa gli URL di callback di Kling.
- Trova i modelli video Kling in Models.
- Consulta Usa polling e webhook per la generazione video.
- Stima il costo dell’attività con Stima il costo della richiesta prima di chiamare un modello.