Używanie adresów URL callback Kling

​

Gdzie tego używać

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

​

Zachowanie 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 odpytywania do uzgadniania, ponowień lub obsługi pominiętych webhooków

​

Lista kontrolna integracji

• Używaj endpointu callback HTTPS, nad którym masz kontrolę
• 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 adresy URL 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"
      }
    ]
  }
}