메인 콘텐츠로 건너뛰기
비동기 이미지와 비디오 작업에 generation.completed, generation.failed를 전송하고 테스트는 endpoint.test입니다. 최소 1회 전달이므로 동일 event ID를 멱등 처리하세요. Token 편집에서 HTTPS 기본 URL, 한 번만 표시되는 32-byte secret, 활성화와 테스트를 설정합니다. callback_url이 없으면 기본 URL을 사용하며, 지정 시 같은 scheme/host/port의 path/query만 변경할 수 있습니다. 미설정 시 400 webhook_not_configured입니다.
최종 실패는 내부 재시도와 환불 또는 과금 확정이 끝난 뒤에만 전송됩니다.
task_type: image|video. 결과는 공개 작업 조회 형식과 같으며 channel ID, upstream task ID/key, credential, PrivateData는 포함하지 않습니다.
서명 원문은 event_id + "." + timestamp + "." + raw_request_body, 알고리즘은 HMAC-SHA256입니다. 최초 요청은 5분 초과 timestamp를 거부하고 secret 회전 후 24시간은 신/구 서명을 모두 허용합니다.
Python
Node.js
Go
첫 전달은 즉시 수행하며 실패 후 10초, 30초, 2분, 10분, 1시간, 6시간, 24시간에 재시도합니다. 2xx만 성공이고 3xx는 따라가지 않으며 4xx/5xx는 재시도합니다. timeout은 10초입니다. 매 전달마다 HTTPS, userinfo, fragment, 잘못된 port, SSRF, DNS/IP와 DNS rebinding을 검증합니다. 실패 시 상태 조회를 대체 경로로 사용하고 만료 가능한 결과 URL을 즉시 저장하세요. 실명 인증, 결제, OAuth callback은 제외됩니다. 속도 제한.