创建响应

OpenAI Responses API：Codex CLI 与 GPT、GLM、千问、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。

创建响应

curl https://api.hop-base.com/v1/responses \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "你好"
  }'

200application/json

{
  "id": "resp_EXAMPLE",
  "object": "response",
  "created_at": 1790222400,
  "status": "completed",
  "model": "gpt-5.6-sol",
  "output": [
    {
      "type": "message",
      "id": "msg_EXAMPLE",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "你好！有什么可以帮你？",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 8,
    "output_tokens": 11,
    "total_tokens": 19,
    "output_tokens_details": {
      "reasoning_tokens": 0
    }
  },
  "error": null
}

请求头

Authorization:必填string

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

请求体参数JSON

model:必填string

当前密钥分组内的模型 ID。支持 Responses 的分组：GPT（Codex）、GLM-5.3、千问、Grok，以及 deepseek-v4.1-flash；Gemini 不支持

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；其他取值会被移除后再转发

可选值priorityflex

previous_response_id:可选string

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

store:可选false

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

默认false

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

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 开新对话

请求头

请求体参数JSON

返回

错误

相关页面