Skip to content
文本生成

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。