Responses
OpenAI Responses 协议。Codex CLI 与 GPT 系列的首选接口,支持多轮状态、工具和推理配置。
POST/v1/responses
请求体
modelstring必填
模型 ID,例如 gpt-5.5、gpt-5.3-codex、grok-4.5。
inputstring | object[]必填
输入文本,或由消息、工具输出等组成的输入项数组。
instructionsstring
系统级指令。
streamboolean
为 true 时以 SSE 返回 response.* 事件。
reasoningobject
推理配置,例如 {"effort": "medium"}。
toolsobject[]
工具定义。
storeboolean
是否在上游保存响应。经网关调用时建议设为 false,由客户端自行维护上下文。
max_output_tokensinteger
最大输出 Token 数。
示例
bash
curl https://api.thetaio.tech/v1/responses \
-H "Authorization: Bearer $THETAIO_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "gpt-5.5",
"instructions": "你是一名代码审查助手。",
"input": "这段 SQL 有什么问题:SELECT * FROM users WHERE id = '\''1'\'' OR 1=1",
"reasoning": {"effort": "medium"},
"store": false
}'python
from openai import OpenAI
client = OpenAI(base_url="https://api.thetaio.tech/v1", api_key="sk-...")
response = client.responses.create(
model="gpt-5.5",
input="写一个判断回文的 Python 函数",
store=False,
)
print(response.output_text)响应
json
{
"id": "resp_...",
"object": "response",
"status": "completed",
"model": "gpt-5.5",
"output": [
{
"type": "message",
"role": "assistant",
"content": [{ "type": "output_text", "text": "……" }]
}
],
"usage": { "input_tokens": 48, "output_tokens": 160, "total_tokens": 208 }
}计算输入 Token
POST/v1/responses/input_tokens
请求体与 /v1/responses 相同,返回输入 Token 数。
WebSocket
GET /v1/responses 升级为 WebSocket 连接,供支持该传输的 Codex 版本使用。非 OpenAI 分组请在客户端设置 supports_websockets = false,使用 HTTP/SSE,见 Codex CLI。