Responses 接口

用 OpenAI Responses 接入 1折AI，了解 input、output、流式事件与兼容边界。

Codex CLI 使用 Responses 协议。自己编写应用时，也可通过 POST https://1zheai.com/v1/responses 请求支持该接口的 GPT 模型。OpenAI SDK Base URL 填 https://1zheai.com/v1。

最小请求

1
curl --fail-with-body --connect-timeout 10 --max-time 120 \
2
  https://1zheai.com/v1/responses \
3
  -H "Authorization: Bearer $ONEZHE_API_KEY" \
4
  -H "Content-Type: application/json" \
5
  -d '{
6
    "model": "gpt-6-astra",
7
    "input": "用三句话解释 API 网关。",
8
    "store": false
9
  }'

运行前设置 ONEZHE_API_KEY，并确认模型在你的可用列表中。store: false 是协议中的存储选项，不等于所有服务层都没有日志或数据保留；不要据此推断隐私承诺。

与 Chat Completions 的区别

内容	Chat Completions	Responses
输入	`messages`	`input`，可为字符串或结构化输入项
文本结果	`choices[].message.content`	`output` 中的 message 内容块
SDK 文本辅助属性	自己提取 choice	`response.output_text`
流式文本	`choices[].delta.content`	`response.output_text.delta` 事件
结束判断	`finish_reason` 与流结束	检查响应状态及终止事件

output_text 是 SDK 提供的便利属性，不应假设原始 HTTP JSON 的顶层存在这个字段。直接调用 HTTP 时，遍历 output，选择 type: message，再读取其 content 中 type: output_text 的 text。

Python SDK

安装 python -m pip install openai 后：

1
import os
2
from openai import OpenAI
3

4
client = OpenAI(
5
    api_key=os.environ["ONEZHE_API_KEY"],
6
    base_url="https://1zheai.com/v1",
7
    timeout=120.0,
8
    max_retries=0,
9
)
10
response = client.responses.create(
11
    model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
12
    input="用三句话解释 API 网关。",
13
    store=False,
14
)
15
print(response.output_text)
16
print("status:", response.status)

这里关闭自动重试，便于首次接入定位单次请求。上线前按超时与重试设置策略。

流式读取

在上面初始化的 client 后使用：

1
with client.responses.create(
2
    model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
3
    input="用三句话解释 API 网关。",
4
    store=False,
5
    stream=True,
6
) as stream:
7
    for event in stream:
8
        if event.type == "response.output_text.delta":
9
            print(event.delta, end="", flush=True)
10
        elif event.type == "response.completed":
11
            print("\n完成")
12
        elif event.type in {"response.failed", "response.incomplete", "error"}:
13
            raise RuntimeError(f"响应未完成：{event.type}")

没有收到完成事件就断开时，应将结果标记为未完成，不能只凭已输出文字判断成功。

兼容范围

本页覆盖创建响应和读取文本。不要由此推断后台任务、历史响应检索、previous_response_id、托管工具、文件存储等能力全部可用。需要会话续接时，先用显式历史输入验证；需要特定工具时，按模型和客户端逐项验证。

配置现成工具请看 Codex CLI。SDK 用法参考 OpenAI Python SDK。