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

<aside className="docs-publication" data-pagefind-ignore>文档由 <a href="https://1zheai.com/editorial/#publisher">1折AI</a> 维护。<a href="https://1zheai.com/editorial/">来源、商业关系与纠错说明</a>。发现错误，请向 <a href="mailto:support@1zheai.com">support@1zheai.com</a> 提供页面地址与可核查依据，不要发送密钥或账号资料。</aside>

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

## 最小请求

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

运行前设置 `ONEZHE_API_KEY`，并确认模型在[你的可用列表](/docs/api-models/)中。`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` 后：

```python
import os
from openai import OpenAI

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

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

## 流式读取

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

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

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

## 兼容范围

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

配置现成工具请看 [Codex CLI](/docs/quickstart-codex/)。SDK 用法参考 [OpenAI Python SDK](https://github.com/openai/openai-python)。