본문으로 건너뛰기
문서

문서 메뉴

멱등성

비스트리밍 요청을 안전하게 재시도하기 위한 Idempotency-Key 헤더와 저장된 응답이 없을 때의 동작.

최종 업데이트 2026-11-04

네트워크가 실패하면 요청이 실행되었는지 알 수 없습니다. 비스트리밍 요청에 Idempotency-Key 헤더(인쇄 가능한 ASCII 1~255자)를 보내면 같은 요청은 최대 한 번만 과금됩니다.

상황결과
같은 키, 같은 요청, 완료, 응답이 아직 메모리에 있음원래 응답이 Idempotent-Replayed: true와 함께 재생되며 비용 없음.
같은 키, 다른 요청409 idempotency_conflict
같은 키, 첫 요청이 아직 실행 중409 idempotency_in_progress
같은 키, 완료되었지만 응답이 더 이상 없음409 idempotency_replay_unavailable

개인정보 보호를 위해 플랫폼은 프롬프트나 응답을 데이터베이스에 저장하지 않습니다. 따라서 재생은 게이트웨이 메모리에서 제공되며 재시작하면 사라집니다. 응답이 없으면 409가 반환되고, 요청은 다시 실행되거나 다시 과금되지 않습니다. 필요하면 새 키로 다시 보내세요. 과금 전에 실패한 요청은 키를 소모하지 않습니다. 스트리밍 요청에서는 헤더가 무시됩니다. 자세한 내용은 영어 문서에 있습니다.