创建响应 (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选填

  是否允许保存请求与响应，取决于所选模型和服务支持范围；不代表提供通用对话存储接口。

• 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选填

  Responses 流参数；与 stream=true 配合，仅支持的字段生效。

  stream_options 子字段（2）

  • include_usageboolean选填

    请求流式用量，是否返回取决于所选模型。

  • include_obfuscationboolean选填

    Responses 流混淆控制；默认忽略，仅在支持此参数时生效。

HTTP 200

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

HTTP 401

HTTP 403

HTTP 429

HTTP 500