Skip to main content
POST
OpenAI Responses 协议入口,除 deepseek-v3.1-terminus 外的全部文本模型都可调用。gpt-5-pro、gpt-5.2-pro、gpt-5.4-pro、gpt-5.3-codex 与 o3-pro 五个模型只接受本接口,不接受 Chat Completions。

鉴权

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

string
必填
模型 ID除 deepseek-v3.1-terminus 外的全部文本模型都可调用本接口。只接受本接口的五个模型:
  • gpt-5-pro
  • gpt-5.2-pro
  • gpt-5.4-pro
  • gpt-5.3-codex
  • o3-pro
这五个模型发到 /v1/chat/completions 会返回 400;deepseek-v3.1-terminus 发到本接口同样返回 400。各模型的计费方式见文本模型总览。
string or array
必填
输入内容,支持字符串或消息数组字符串形式即一次性文本输入;数组形式用于多轮:
integer
本次请求的输出预算思考 token 也从这个预算里扣。status: "incomplete" 表示输出可能没写完,不能当作完整回答。
array
工具列表
这五个模型不支持工具调用与结构化输出,tools、tool_choice、response_format 都会返回 400,不计费。需要函数调用请改用支持工具的其他模型。
number
控制输出随机性,范围 0-2默认值:1.0
integer
生成的最大 token 数量
boolean
是否使用流式输出默认值:false

响应

string
响应的唯一标识符
string
对象类型,固定为 response
integer
创建时间戳
string
实际使用的模型名称
string
响应状态可能的值:
  • completed - 已完成
  • in_progress - 处理中
  • failed - 失败
  • cancelled - 已取消
array
输出内容数组
object
token 使用统计
object
推理配置信息(思考模型专用)
number
实际使用的采样温度
number
实际使用的核采样参数
string
工具选择策略
array
使用的工具列表
boolean
是否允许并行工具调用
boolean
是否存储对话历史
string
服务等级
string
截断策略
object
文本格式配置
boolean
是否为后台任务
object
错误信息(如果有)
object
元数据信息

使用示例

单次输入

多轮输入

限制输出预算

思考 token 也从 max_output_tokens 里扣。响应 status 为 "incomplete" 时表示预算用尽,输出可能没写完。

流式输出

用量与计费

usage.input_tokens 是输入总量(含 input_tokens_details.cached_tokens),usage.output_tokens 已包含 output_tokens_details.reasoning_tokens,思考 token 只按输出价计一次。这五个模型目前都是输入 / 输出两项计价,没有独立缓存价,响应里的缓存统计按普通输入价计。单价与计费通则见文本模型总览 · 计费口径。 流式计费取终态用量:以 response.completed、response.incomplete、response.failed 或 response.cancelled 事件里的 usage 为准。失败或截断的响应同样可能产生 token 费用;HTTP 200、部分文本或 [DONE] 都不足以证明拿到了完整用量。
没有拿到终态用量时,冻结的额度会保留待核对。请先到控制台核对这次调用的用量记录,不要自动重发。

当前不支持

以下请求会返回 400,不计费:
  • 托管工具 —— file_search、remote_mcp 等厂商内置工具;web_search 的可用模型与计费见文本模型总览 · 计费口径。
  • 上述五个模型的工具调用与结构化输出 —— 见上方 tools 说明。
  • service_tier 取 standard / default 以外的值。
  • 图像与视频输入。

相关文档