응답 생성
OpenAI 호환 응답 API를 사용하여 모델 출력을 생성합니다.
텍스트 또는 구조화된 모델 입력과 통합된 출력 객체에 응답 API 모양을 사용합니다.
/openai/v1/responses요청 본문
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
model | 문자열 | 예 | AnyInt에서 라우팅된 모델 식별자입니다. |
input | 문자열 또는 배열 | 예 | 텍스트 또는 구조화된 입력 항목입니다. |
stream | 부울 | 아니요 | 지원되는 경우 서버 전송 이벤트 반환 |
reasoning.effort | 문자열 | 아니요 | 모델에 따른 추론 강도로, 자동으로 낮추지 않고 그대로 전달됩니다. |
tools | 배열 | 아니요 | 사용자 정의 도구를 포함한 도구 선언입니다. |
응답
완료된 요청은 식별자, 상태 및 생성된 출력이 포함된 응답 객체를 반환합니다.
도구 기록 및 유효성 검사
사용자 정의 도구 호출과 다중 파트 도구 출력은 원래의 순서와 유니코드 텍스트를 유지합니다. 어시스턴트 output_text 파트가 생략되거나 null인 경우 빈 annotations 및 logprobs 배열이 제공되어 릴레이가 이를 잘못된 null 메타데이터로 재구성하지 않도록 합니다. 공급자의 연결 유지 메시지는 대화 기록에서 제외됩니다。
추론 강도 지원은 선택한 모델과 업스트림에 따라 다릅니다. 구조화된 거부는 필드를 식별합니다(예: error.code: "invalid_value" 및 error.param: "reasoning.effort"). 찾을 수 없거나 릴레이에서 생성된 형식 거부는 유효한 클라이언트 기록을 잘못된 형식으로 식별하는 대신 업스트림 오류를 반환합니다。
스트리밍 및 복구
성공적인 스트림은 response.completed로 종료되며, 출력 제한에 도달하면 response.incomplete로 종료될 수 있습니다. 업스트림 실패, 시간 초과 또는 조기 EOF는 response.failed를 생성합니다. 실패한 스트림은 조작된 성공 종료나 기존 [DONE] 마커를 받지 않습니다. HTTP 상태가 200인 경우에도 종료 이벤트를 확인하십시오. 종료 스트림 오류가 발생해도 디스패치된 작업이 자동으로 재생되지 않습니다。
하트비트는 SSE 주석을 사용합니다. 공급자의 response.metadata 이벤트 및 SSE-Keep-Alive 출력 항목은 필터링됩니다. 이벤트 sequence_number 값은 단조롭게 증가합니다。
선택적 x-client-message-id 및 x-resume-message-id 헤더는 이벤트 오프셋 복구를 선택합니다. x-anyint-resume-offset-unit: sse-event는 해당 오프셋을 설명하고 x-anyint-stream-replayed: true는 재생을 식별합니다. 선택하지 않은 클라이언트는 이러한 확장 헤더를 무시할 수 있습니다。
호환성 별칭
기존 클라이언트는 계속해서 /v1/responses을 사용할 수 있습니다. 새 통합은 /openai/v1/responses을 사용해야 합니다.