---
title: "Responses インターフェース"
description: "OpenAI Responses を使用して 1折AI に接続し、input、output、ストリーミングイベントと互換性の範囲を理解します。"
headingIds: {"最小リクエスト":"section-1","Chat Completions との違い":"section-2","Python SDK":"section-3","ストリーミング読み取り":"section-4","互換性の範囲":"section-5"}
---

<aside className="docs-publication" data-pagefind-ignore>

ドキュメントは [1ZheAI](https://1zheai.com/en/editorial/#publisher) が管理しています。[出典と訂正](https://1zheai.com/en/editorial/)。

エラーを見つけましたか？ページのアドレスと説明を添えて[サポートに連絡](mailto:support@1zheai.com)してください。API キーやアカウント情報は送信しないでください。

</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` を設定し、モデルが[利用可能なモデル一覧](/ja/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)
```

ここでは自動リトライを無効にしており、初回接続時に単一リクエストの問題を特定しやすくしています。本番導入前に[タイムアウトとリトライ](/ja/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 ](/ja/docs/quickstart-codex/) を参照してください。SDK の使用方法は [OpenAI Python SDK ](https://github.com/openai/openai-python) を参照してください。