Skip to main content
모든 async 작업은 조회 가능한 task ID를 반환하므로, 비디오 생성에서는 polling을 기본 방식으로 사용하세요. 선택한 비디오 endpoint가 callback URL을 지원하는 경우에만 webhook을 추가하고, 누락되었거나 provider별로 다를 수 있는 callback 전달에 대해서는 polling을 기준 정보로 유지하세요.

비디오 task 생성

다음 요청은 최소한의 비디오 task를 생성하고 반환된 ID를 저장합니다. duration, resolution 또는 callback 필드는 선택한 모델 페이지에서 해당 필드가 문서화된 경우에만 추가하세요.
응답에는 task ID와 상태가 포함됩니다:

상태 poll

다음 요청은 비디오 task 상태를 확인합니다:
응답은 task 진행에 따라 변경됩니다. 완료된 응답에는 모델 adapter에 결과 URL이 있는 경우 video_url이 포함될 수 있습니다. 그렇지 않다면 모델별 결과 필드 또는 해당 모델이 프록시 다운로드를 지원할 때 /v1/videos/{id}/content content route를 사용하세요.

webhook 수신

CometAPI는 모든 비디오 모델에 대해 하나의 범용 callback payload를 정의하지 않습니다. callback은 provider별 pass-through 이벤트로 취급하고, 원본 body를 저장한 뒤 최종 상태는 polling으로 대조하세요. 다음 Express handler는 비디오 callback을 수신하고 이벤트를 저장합니다:
callback payload에는 일반적으로 task 식별 정보와 상태 필드가 포함되지만, 정확한 중첩 구조는 선택한 모델이나 provider에 따라 달라집니다:

일반적인 오류

관련 링크

마지막 수정일 2026년 6월 23일