Responses streaming events — 이벤트 타입 레퍼런스
Responses streaming events — 이벤트 타입 레퍼런스
stream: true 로 Response를 만들면 서버가 Response가 생성되는 동안 클라이언트에 서버 전송 이벤트(SSE) 를 내보내요. 이 레퍼런스 페이지는 그 이벤트들의 타입을 정리해요.
이벤트 구조
각 이벤트는 정의된 스키마를 갖고, type 필드로 구분돼요. 스트리밍 응답을 제대로 다루려면 이 이벤트 타입 목록을 아는 게 필수예요.
주요 이벤트 유형
response.created: Response 객체가 생성됨.response.output_text.delta: 출력 텍스트의 증분 조각.response.completed: 전체 생성 종료.error: 처리 중 오류.
생성된 Response에는 id, created_at, 프롬프트 템플릿 참조, 추론(reasoning) 설정 참조 같은 메타데이터가 함께 담겨요.
활용 팁
- 이벤트를 그대로 소비하거나 필요한 이벤트만 필터링해 UI에 반영해요.
- 도구 호출·추론 토큰 등 고급 이벤트도 타입별로 다룰 수 있어요.