← 모든 글

"비디오 아바타" 섹션의 웹후크: 비디오가 준비되면 서버에 알림

밝은 장면: 완성된 비디오가 재생 버튼과 함께 화면에 표시되고 빛나는 신호선이 여기에서 깔끔한 서버로 이동하며 서버 위에서 알림 벨이 깜박입니다.

섹션의 웹훅 "비디오 아바타" 페이지를 수동으로 새로 고치지 않고도 비디오가 준비되었는지 확인하는 방법입니다. 비디오가 완료되자마자 POST 요청이 서버 주소로 전송되고 서버 자체에서 다음에 수행할 작업을 결정합니다. 즉, 데이터베이스에 링크를 작성하거나 클라이언트에 파일을 보내거나 다음 단계를 시작합니다. 이 탭은 비디오를 일괄적으로 제작하거나 아바타 생성을 제품에 통합하는 사람들에게 필요합니다. 끝없는 "준비 여부"를 확인하는 대신 정확한 순간에 하나의 짧은 알림이 도착합니다.

이것이 왜 필요한가요?

비디오 렌더링은 즉각적인 작업이 아니며 열린 탭에서 기다릴 필요가 없습니다. 2026년 9월 7일자 플랫폼 측정에 따르면 1080p의 5초 Kling 3.0 동영상은 평균 115초로 간주되며 95%의 경우 165초에 맞습니다. Sora 2의 경우 동일한 작업에 평균 약 145초가 걸립니다. 몇 초마다 상태를 확인하면 하나의 영상에 수십 개의 빈 요청이 나타납니다. 웹훅은 결과가 실제로 나타날 때 한 번만 제공됩니다.

볼륨 자체도 말해줍니다. 플랫폼의 생성 로그에 따르면 30일 동안(2026년 9월 3일~10월 2일) 3,292개의 비디오 작업이 시작되었으며 그 중 2,369개가 성공적으로 완료되었습니다. 비디오는 백그라운드에서 계산되고 다른 시간에 종료됩니다. 이는 수동으로 추적할 수 없으며 깔끔한 알림 처리기가 문제 자체를 해결합니다.

"웹후크" 탭은 무엇을 합니까?

마술 없이 알림을 전달하는 것이 전부입니다. 주소를 등록하고, 구독할 이벤트를 선택하고, 구독 비밀을 받으세요. 등록된 엔드포인트 목록이 바로 여기에 저장됩니다. 주소, 선택한 이벤트, 상태 및 엔드포인트에 비밀이 있는지 여부를 볼 수 있습니다. 비밀을 다시 공개하거나(이전 비밀은 즉시 작동을 중지함) 엔드포인트를 완전히 삭제할 수 있습니다.

이벤트는 귀하의 동영상에서만 발생합니다. 다른 사람의 동영상은 동시에 계산되더라도 나가지 않습니다. 전달된 이벤트에 대한 로그도 있으므로 실제로 서버에 도달한 내용을 확인하는 것이 편리합니다.

시작하는 방법 - 단계별

  1. 섹션 열기 "비디오 아바타" 및 직접 주소의 웹훅 패널 /ru/avatars?tab=webhooks.
  2. 귀하의 계정에 로그인하십시오. 손님은 설정을 사용할 수 없습니다. 클릭하면 로그인 창이 열립니다.
  3. "엔드포인트 주소" 필드에 서버의 공개 HTTPS 주소를 입력합니다(예: https://example.com/avatar-webhook). HTTP는 작동하지 않습니다. 전달 및 서명은 보안 채널을 위해 설계되었습니다.
  4. 필수 이벤트를 표시하세요. 아무 것도 선택하지 않으면 모든 이벤트를 한 번에 구독하게 됩니다.
  5. "엔드포인트 추가"를 클릭하세요. 생성 직후 구독 비밀이 표시됩니다. 직접 복사하여 저장하면 다시 표시되지 않습니다.
  6. 아직 자체 서버가 없는 경우 "수신자 대체"를 클릭하세요. 그러면 탭에서 직접 전달된 이벤트 로그에 알림이 누적됩니다.

해당 요청이 당사에서 보낸 것인지 가짜가 아닌지 확인하는 방법

각 요청에는 서명 헤더가 수반됩니다. 이는 요청의 원시 본문에서 비밀로 계산된 HMAC-SHA256입니다. 귀하 측에서는 동일한 서명을 세어 비교하십시오. 일치하지 않으면 요청을 폐기합니다. 우리의 수신자는 이를 정확하게 수행하고 잘못된 서명에 대해 401로 응답합니다. 클라이언트 코드가 아닌 서버, 환경 변수에 비밀을 유지하세요.

요청 내용

본문은 이벤트 유형과 엔터티 데이터가 포함된 일반 JSON입니다. 예를 들어 완성된 비디오의 경우 내부에 비디오 식별자가 있는 BLK0 이벤트입니다. 사용 가능한 이벤트 유형의 전체 목록이 탭에 표시됩니다. 이를 정렬하고 서비스에 실제로 필요한 것만 남길 수 있습니다.

비용은 얼마입니까?

엔드포인트 등록, 비밀 재공개, 삭제 및 이벤트 로그는 토큰을 기록하지 않습니다. 이는 생성이 아닌 알림 설정입니다. 토큰은 비디오 자체에만 사용됩니다. 토큰 가격은 출시 전에 표시되며 작업이 실패하면 상쇄된 금액이 반환됩니다. 구독이 없습니다. 신규 사용자에게는 첫 번째 테스트에 대한 시작 토큰이 제공됩니다.

무엇과 결합할까요?

자주 묻는 질문

웹훅에 적합한 주소는 무엇인가요?

공개 HTTPS 전용입니다. 로컬 주소와 HTTP는 허용되지 않습니다. 알림은 보안 채널을 통해 전달되어야 하며 서버는 외부에서 액세스할 수 있어야 합니다.

서버가 없어도 알림을 받을 수 있나요?

예. "수신자 대체"를 클릭하세요. 이벤트는 탭의 "전달된 이벤트" 로그에 누적되며 백엔드 없이도 볼 수 있습니다.

서명이 일치하지 않으면 어떻게 해야 하나요?

원시 요청 본문(파싱된 JSON이 아님)에서 HMAC-SHA256을 읽고 있는지, 그리고 현재 비밀 정보를 사용하고 있는지 확인하세요. 다시 발행한 후에는 이전 비밀 비밀이 즉시 작동을 멈춥니다.

이거 유료인가요?

웹훅을 설정해도 토큰은 기록되지 않습니다. 토큰은 비디오 생성에만 사용됩니다. 가격은 출시 전에 표시됩니다. 구독이 없으며 신규 사용자에게 시작 토큰이 제공됩니다.