文档目录
RESPONSES API
调用与流式输出
Responses API 是推荐的文本生成入口。先获取当前 Key 可用的模型，再选择普通 JSON 响应或 SSE 流式输出。
查询可用模型
模型可见范围由 API Key 所属分组决定。每次接入新环境时，先查询模型列表，不要在业务逻辑里假设某个示例模型一定存在。
curl https://www.tokensupply.net/v1/models \
-H "Authorization: Bearer $TOKENSUPPLY_API_KEY"创建响应
最小请求包含 model 和 input。示例使用非流式模式，服务会在生成完成后返回一个 JSON 响应。
curl https://www.tokensupply.net/v1/responses \
-H "Authorization: Bearer $TOKENSUPPLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"input": "写一个 Go 健康检查函数",
"stream": false
}'from openai import OpenAI
client = OpenAI(
api_key="sk-your-key",
base_url="https://www.tokensupply.net/v1",
)
response = client.responses.create(
model="gpt-5.6-sol",
input="写一个 Go 健康检查函数",
)
print(response.output_text)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.TOKENSUPPLY_API_KEY,
baseURL: "https://www.tokensupply.net/v1",
});
const response = await client.responses.create({
model: "gpt-5.6-sol",
input: "写一个 Go 健康检查函数",
});
console.log(response.output_text);
请求体必须完整送达请发送有效 JSON，并保持
Content-Type: application/json。客户端提前断开或代理截断请求体时，服务可能返回 “Failed to read request body”。
SSE 流式输出
将 stream 设为 true 后，响应使用 Server-Sent Events 持续返回事件。客户端应逐行消费数据，直到完成事件或连接关闭。
curl --no-buffer https://www.tokensupply.net/v1/responses \
-H "Authorization: Bearer $TOKENSUPPLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"input": "分三步解释事件循环",
"stream": true
}'- 不要让反向代理缓冲整个响应。
- 为长任务设置足够的读取超时，并正确处理用户主动取消。
- 流开始后发生的错误可能以流内事件返回，而不是新的 HTTP 状态码。
Chat Completions 兼容
已有应用只支持 Chat Completions 时，可以继续调用 POST /v1/chat/completions。新接入优先选择 Responses API，以获得更统一的输入和事件模型。
curl https://www.tokensupply.net/v1/chat/completions \
-H "Authorization: Bearer $TOKENSUPPLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "你好"}]
}'HTTP 与 WebSocket
POST /v1/responses 是普通 HTTP/SSE 入口。GET /v1/responses 仅用于 WebSocket Upgrade，不能用浏览器地址栏或普通 GET 请求代替握手。
看到 426 时当前请求进入了 WebSocket 路径，但没有携带有效的
Upgrade: websocket 握手。普通应用应改回 POST；Codex 用户可关闭 WebSocket 配置。