Responses | Aibubu Developers

POST /v1/responses 适用于文字模型。它与 Chat Completions 二选一即可，不用于图片或视频生成；模型 ID 以 GET /v1/models 为准。

请求

POST /v1/responses
Authorization: Bearer sk_yeehoo_your_api_key
Content-Type: application/json
Idempotency-Key: response-demo-001

字段	类型	必填	说明
`model`	`string`	是	`/v1/models` 返回的文字模型 ID
`input`	`string` 或 `array`	是	当前输入，可传字符串或多轮消息数组
`instructions`	`string`	否	系统级提示词
`stream`	`boolean`	否	是否以 SSE 流式返回，默认 `false`
`reasoning`	`object`	否	推理配置，例如 `{ "effort": "high" }`

系统提示词

不需要自定义 systemPrompt 字段。Responses 使用顶层 instructions：

{
  "model": "gpt_5_6_luna",
  "instructions": "请使用中文回答，并给出可运行代码。",
  "input": "帮我写一个 Python 示例"
}

多轮对话

将历史消息放入 input 数组，并按时间顺序传入：

{
  "model": "gpt_5_6_luna",
  "instructions": "回答要简洁。",
  "input": [
    { "role": "user", "content": "帮我写一个爬虫" },
    { "role": "assistant", "content": "你想使用什么语言？" },
    { "role": "user", "content": "Python" }
  ]
}

非流式响应

{
  "id": "resp_123",
  "object": "response",
  "model": "gpt_5_6_luna",
  "output_text": "下面是一个 Python 示例。"
}

流式响应

设置 "stream": true 后，响应为 text/event-stream，客户端应逐个处理事件中的增量文本：

data: {"type":"response.output_text.delta","delta":"下面是"}
data: {"type":"response.output_text.delta","delta":"一个 Python 示例。"}
data: {"type":"response.completed"}

Compact 与 WebSocket

POST /v1/responses/compact：使用 Responses 风格提交压缩上下文请求，字段规则与 /v1/responses 一致。
GET /v1/responses：仅用于 WebSocket Upgrade 的流式桥接；普通 GET 不会返回生成结果。

常见错误

model_not_found 或无权限：模型不存在、未公开或 API Key 未授权。
无可用路由：模型或 CodexReverse 渠道没有启用路由。
参数不支持：请求字段不在该模型的 Schema 中。
余额不足：账户余额不足以完成本次请求。
上游调用失败：上游暂时不可用，可按错误响应和幂等键安全重试。

图片和视频请使用异步的 POST /v1/generations，不要使用本接口。