跳到正文

创建响应

OpenAI Responses API:Codex CLI 与 GPT、千问、DeepSeek、Grok 等模型使用;无状态,每轮需发送完整历史。

POST/v1/responses

OpenAI Responses 兼容端点,Codex CLI 走这里。HopBase 的 Responses 是无状态的:store 固定为 false,previous_response_id 会被移除,多轮对话请每次发送完整 input。

未列出的字段原样转发;模型不收的字段(如 DeepSeek 的 truncation、reasoning.summary)由各模型页说明是否静默删除。流式输出中途失败时以 event: response.failed 下发,HTTP 状态仍为 200。

产生扣费的非流式响应会返回本次实际扣费:响应头 X-HopBase-Cost / X-HopBase-Cost-USD / X-HopBase-Currency,以及响应体根对象 usage 里的 cost / cost_usd / currency(usage 原有字段保留)。cost_usd 为本次从余额实际扣除的美元金额,cost 为同一笔扣费的人民币金额,currency 恒为 CNY。流式(SSE)不返回,请到控制台「使用记录」查看;未扣费的响应(如错误)不带。详见账户 API · 扣费。

请求头

Authorization:必填string

Bearer sk-…:控制台「API 密钥」里创建的密钥,所属分组须包含请求的模型

请求体参数JSON

model:必填string

当前密钥分组内的模型 ID。支持 Responses 的分组:GPT(Codex、Azure)、千问、DeepSeek(含美国区)、GLM 美国区、Grok、「Kimi K3 系列 自部署」、「Gemini 特价版(AI Studio / Vertex)」与「Gemini 官方直连(企业级)」;GLM-5.3、GLM-5.3 Flash 与「Kimi K3 云厂商」分组不支持

input:必填string 或 array of object

字符串会自动包成单条用户消息;也可传消息数组。千问的内容分片只收 input_text、input_image、input_file,不收视频

max_output_tokens:可选integer

输出上限。网关不截断、不改写;上限按模型官方规格

stream:可选boolean

true 返回 Responses SSE 事件流,见流式事件

默认false

tools:可选array of object

工具定义,原样转发。Responses 的函数工具是扁平结构(name 与 type 同级),不同于 Chat Completions

tool_choice:可选string 或 object

原样转发

reasoning:可选object

推理配置,原样转发。Codex CLI 的 model_reasoning_effort 即写入这里

service_tier:可选string

只保留 priority / flex;其他取值会被移除后再转发。priority 仅在所用分组支持时生效并按 Fast 价计费,不支持时按标准档处理、按标准价计费;「GPT 官方直连(Azure)」分组不支持 priority

可选值priorityflex

previous_response_id:可选string

不支持:网关会移除此字段,不会接续上一轮。多轮对话请在 input 里带上完整历史

store:可选false

固定为 false:服务端不保存响应,不能事后按 ID 取回

默认false

返回

200成功。非流式为 response JSON;stream: true 时为 SSE

响应头

X-HopBase-Cost:可选string

本次请求扣费的人民币金额(与 X-HopBase-Cost-USD 为同一笔扣费),最多 6 位小数,如 0.0816。只在本次产生扣费时返回;流式(SSE)不返回;生图耗时约 40 秒以上时响应头已提前发出,以响应体 usage.cost 为准

X-HopBase-Cost-USD:可选string

本次请求实际从余额扣除的美元金额,与使用记录里这一条相同,最多 8 位小数,如 0.012;只随 X-HopBase-Cost 一起返回

X-HopBase-Currency:可选string

X-HopBase-Cost 的币种,恒为 CNY

id:可选string

响应 ID(store 固定为 false,不能按 ID 取回)

object:可选"response"
created_at:可选integer

Unix 秒

status:可选string

completed / incomplete / failed

model:可选string

模型 ID

output:可选array of object

输出项:message、reasoning、function_call 等

usage:可选object

Token 用量

error:可选object 或 null

失败时的错误

错误

400请求体无法读取或缺字段
401没带密钥、密钥无效或已过期(missing_api_key / invalid_api_key / api_key_expired)
402余额或密钥 / 成员 / 部门额度用完(insufficient_quota)
404模型不在这把密钥的分组里(model_not_found),或路径不属于该分组(route_not_found)
413请求体超过 60 MB(request_too_large)
429帐户或密钥并发已达上限(user_concurrency_limit / apikey_concurrency_limit),带 Retry-After
503提示有状态会话「can no longer be resumed」时,去掉 previous_response_id 开新对话

相关页面