응답 생성

OpenAI 호환 응답 API를 사용하여 모델 출력을 생성합니다.

텍스트 또는 구조화된 모델 입력과 통합된 출력 객체에 응답 API 모양을 사용합니다.

POST/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을 사용해야 합니다.