응답 생성(OpenAI Responses API)

요청 본문 · application/json

유형

object

필수 필드

modelinput

요청 본문 필수

• modelstring필수

• inputunion필수

  문자열 또는 메시지 배열 형태의 입력 콘텐츠

  oneOf 분기 1

  유형: string
  oneOf 분기 2

  유형: array

  • []object선택 사항

• instructionsstring선택 사항

• max_output_tokensinteger선택 사항

• temperaturenumber선택 사항

  샘플링 온도입니다. 구체적인 지원과 제한은 선택한 모델에 따라 다르며 공통 기본값은 보장되지 않습니다.

• top_pnumber선택 사항

  핵 샘플링 매개변수입니다. 구체적인 지원과 제한은 선택한 모델에 따라 다르며 공통 기본값은 보장되지 않습니다.

• streamboolean선택 사항

• toolsarray선택 사항
  tools 하위 필드(1)

  • []object선택 사항

• tool_choiceunion선택 사항
  oneOf 분기 1

  유형: string
  oneOf 분기 2

  유형: object
• reasoningobject선택 사항
  reasoning 하위 필드(2)

  • effortstring선택 사항

    열거형

    ["low","medium","high"]

  • summarystring선택 사항

• previous_response_idstring선택 사항

• truncationstring선택 사항

  열거형

  ["auto","disabled"]

• parallel_tool_callsboolean선택 사항

  병렬 도구 호출 허용 여부는 선택한 모델에 따라 달라집니다. Chat은 불리언을, Responses는 호환 프로토콜의 JSON 값을 받습니다.

• storeboolean선택 사항

  요청과 응답의 저장 허용 여부는 선택한 모델과 서비스 지원 범위에 따라 달라집니다. 일반적인 대화 저장 API를 제공한다는 의미는 아닙니다.

• prompt_cache_keystring선택 사항

  서비스 프롬프트 캐시 연결 식별자입니다. 모델에 따라 다르며 캐시 적중이나 지원을 보장하지 않습니다. Chat은 문자열을, Responses는 서비스 프로토콜 JSON 값을 허용합니다.

• prompt_cache_retentionunknown선택 사항

  JSON 값인 서비스 프롬프트 캐시 보관 제어입니다. 모델에 따라 다르며 플랫폼은 공통 열거형, 기본값이나 캐시 보관을 보장하지 않습니다.

• service_tierstring선택 사항

  요청할 서비스 등급으로 요금에 영향을 줄 수 있습니다. 기본적으로 무시되며 지원하는 경우에만 적용됩니다. 허용 값은 선택한 모델에 따라 달라집니다.

• textobject선택 사항

  구조화 출력용 format 등의 텍스트 출력 설정입니다. 지원과 제한은 선택한 모델에 따라 다릅니다.

  text 하위 필드(1)

  • formatobject선택 사항

    모델에 따른 텍스트 및 구조화 출력 형식 설정입니다.

    format 하위 필드(4)

    • typestring선택 사항

      선택한 모델이 지원하는 출력 형식 식별자입니다.

    • namestring선택 사항

      구조화된 출력 이름입니다.

    • schemaobject선택 사항

      구조화 출력용 JSON Schema로 선택한 모델의 요구 사항을 충족해야 합니다.

      추가 속성

      true

    • strictboolean선택 사항

      모델 지원에 따라 엄격한 구조화 출력을 요청합니다.

• context_managementunknown선택 사항

  모델에 따른 컨텍스트 관리 설정으로 자동 요약이나 영구 메모리를 보장하지 않습니다.

• stream_optionsobject선택 사항

  stream=true와 함께 사용하는 Responses 스트리밍 설정으로 지원되는 필드만 적용됩니다.

  stream_options 하위 필드(2)

  • include_usageboolean선택 사항

    스트리밍 사용량을 요청하며 반환 여부는 모델에 따라 다릅니다.

  • include_obfuscationboolean선택 사항

    Responses 스트림 난독화 설정으로 기본적으로 무시되며 지원될 때만 적용됩니다.

HTTP 200

{
  "type": "string",
  "description": "SSE 事件流，协议事件/用量/结束符取当前接口，错误可能在流内。"
}

HTTP 401

HTTP 403

HTTP 429

HTTP 500