Usare gli URL di callback di Kling

​

Dove usarlo

• Attività text-to-video e image-to-video
• Attività di avatar e video-effects
• Altre route asincrone di Kling che espongono un campo callback_url opzionale

​

Comportamento di consegna

• Kling invia una richiesta POST al tuo endpoint di callback ogni volta che cambia lo stato dell’attività
• Gli stati comuni sono submitted, processing, succeed e failed
• Il payload può includere task_result.images o task_result.videos a seconda del tipo di attività
• Mantieni disponibile anche il polling manuale per riconciliazione, retry o gestione di webhook mancati

​

Checklist di integrazione

• Usa un endpoint di callback HTTPS sotto il tuo controllo
• Accetta aggiornamenti di stato ripetuti per lo stesso id attività
• Considera la consegna del webhook come asincrona ed eventualmente consistente
• Salva rapidamente gli URL finali delle risorse se il tuo flusso di lavoro richiede uno storage durevole

{
  "task_id": "string",
  "task_status": "string",
  "task_status_msg": "string",
  "created_at": 1722769557708,
  "updated_at": 1722769557708,
  "task_result": {
    "images": [
      {
        "index": 0,
        "url": "https://example.com/generated-image.png"
      }
    ],
    "videos": [
      {
        "id": "string",
        "url": "https://example.com/generated-video.mp4",
        "duration": "5"
      }
    ]
  }
}