URL callback

Użyj callback_url w asynchronicznych zadaniach Kling, gdy chcesz otrzymywać dane metodą push zamiast polegać wyłącznie na polling.

Gdzie tego używać

Zadania text-to-video i image-to-video
Zadania avatar i video-effects
Inne asynchroniczne endpointy Kling, które udostępniają opcjonalne pole callback_url

Sposób dostarczania

Kling wysyła żądanie POST do Twojego endpointu callback za każdym razem, gdy zmienia się status zadania
Typowe statusy to submitted, processing, succeed i failed
Payload może zawierać task_result.images lub task_result.videos w zależności od typu zadania
Zachowaj możliwość ręcznego polling na potrzeby uzgadniania, ponownych prób lub obsługi pominiętych webhooków

Lista kontrolna integracji

Używaj endpointu callback HTTPS, który kontrolujesz
Akceptuj powtarzające się aktualizacje statusu dla tego samego id zadania
Traktuj dostarczanie webhooków jako asynchroniczne i ostatecznie spójne
Szybko zapisuj końcowe URL-e zasobów, jeśli Twój workflow wymaga trwałego przechowywania

{
  "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"
      }
    ]
  }
}