메인 콘텐츠로 건너뛰기
순수 폴링 대신 푸시 방식으로 전달받고 싶다면 Kling 비동기 작업에서 callback_url을 사용하세요.

​
사용 위치

  • 텍스트-투-비디오 및 이미지-투-비디오 작업
  • 아바타 및 비디오 효과 작업
  • 선택적 callback_url 필드를 제공하는 기타 Kling 비동기 라우트

​
전달 동작

  • 작업 상태가 변경될 때마다 Kling이 콜백 엔드포인트로 POST 요청을 보냅니다
  • 일반적인 상태는 submitted, processing, succeed, failed입니다
  • 작업 유형에 따라 payload에 task_result.images 또는 task_result.videos가 포함될 수 있습니다
  • 조정, 재시도 또는 누락된 webhook 처리를 위해 수동 폴링도 계속 사용할 수 있도록 유지하세요

​
통합 체크리스트

  • 직접 제어할 수 있는 HTTPS 콜백 엔드포인트를 사용하세요
  • 동일한 task id에 대한 반복 상태 업데이트를 허용하세요
  • webhook 전달은 비동기적이며 최종적으로 일관성이 맞춰지는 방식이라고 간주하세요
  • 워크플로에 내구성 있는 저장소가 필요하다면 최종 asset URL을 빠르게 저장하세요
{
  "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"
      }
    ]
  }
}