OpenAI Responses

POST/v1/responses

通过 OpenAI Responses 兼容入口执行文本、工具和多模态请求。

网关会根据所选模型的 Provider 协议直接转发或转换请求。请只使用当前模型和路由支持的字段。

核心请求字段

字段	类型	必填	说明
`model`	string	是	从 /v1/models 获取的模型 ID。
`input`	string \| array	是	文本或 Responses 输入项列表。
`instructions`	string	否	本次响应的高层指令。
`stream`	boolean	否	设为 true 时返回 Responses SSE 事件。
`tools`	array	否	模型可调用的工具定义。
`max_output_tokens`	integer	否	期望的最大输出 Token 数。

请求示例

curl https://api.noxgate.net/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"Hello","stream":false}'

from openai import OpenAI

client = OpenAI(api_key="sk-your-api-key", base_url="https://api.noxgate.net/v1")
response = client.responses.create(model="YOUR_MODEL_ID", input="Hello")
print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "sk-your-api-key", baseURL: "https://api.noxgate.net/v1" });
const response = await client.responses.create({ model: "YOUR_MODEL_ID", input: "Hello" });
console.log(response.output_text);

流式响应

stream=true 时返回 Responses 风格 SSE 事件。客户端应按 event/data 处理增量，并等待完成事件；流开始后的错误也可能以事件形式返回。

curl https://api.noxgate.net/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"Hello","stream":true}'

上下文压缩

POST /v1/responses/compact 使用相同鉴权和模型路由，用于兼容支持上下文压缩的 Provider。是否可用取决于所选模型路由。

curl https://api.noxgate.net/v1/responses/compact \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"Hello","stream":false}'

成功响应

{"id":"resp_example","object":"response","model":"YOUR_MODEL_ID","status":"completed","output":[],"usage":{"input_tokens":8,"output_tokens":3,"total_tokens":11}}