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 を参照してください。