Responses-Schnittstelle

Verbinde dich über die OpenAI Responses-Schnittstelle mit 1折AI und verstehe Input, Output, Streaming-Ereignisse und Kompatibilitätsgrenzen.

Codex CLI verwendet das Responses-Protokoll. Wenn du eigene Anwendungen schreibst, kannst du über POST https://1zheai.com/v1/responses GPT-Modelle anfragen, die diese Schnittstelle unterstützen. Die Base URL des OpenAI SDK wird mit https://1zheai.com/v1 ausgefüllt.

Minimalanfrage

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
  }'

Vor dem Ausführen ONEZHE_API_KEY setzen und sicherstellen, dass das Modell in deiner verfügbaren Liste enthalten ist. store: false ist eine Speicheroption im Protokoll und bedeutet nicht, dass auf allen Serviceebenen keine Protokollierung oder Datenaufbewahrung stattfindet; leite daraus keine Datenschutzversprechen ab.

Unterschiede zu Chat Completions

Inhalt	Chat Completions	Responses
Eingabe	`messages`	`input`, kann ein String oder strukturierte Eingabeelemente sein
Textergebnis	`choices[].message.content`	Message-Inhaltsblock in `output`
SDK-Text-Hilfsattribute	choice selbst extrahieren	`response.output_text`
Streaming-Text	`choices[].delta.content`	`response.output_text.delta`-Ereignisse
Ende-Bestimmung	`finish_reason` und Stream-Ende	Antwortstatus und Beendigungsereignis prüfen

output_text ist ein vom SDK bereitgestelltes Komfortattribut; gehe nicht davon aus, dass dieses Feld auf oberster Ebene der rohen HTTP-JSON existiert. Bei direktem HTTP-Aufruf über output iterieren, type: message auswählen und dann dessen content mit type: output_text aus text lesen.

Python SDK

Nach der Installation von 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)

Hier wird automatisches Wiederholen deaktiviert, um die erste Integration bei einer einzelnen Anfrage zu erleichtern. Vor dem Produktivbetrieb die Strategie gemäß Timeout und Wiederholen einstellen.

Streaming-Lesen

Nach dem oben initialisierten client verwenden:

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}")

Wenn die Verbindung getrennt wird, ohne ein Abschlusseignis zu empfangen, sollte das Ergebnis als unvollständig markiert werden; Erfolg darf nicht allein anhand des bereits ausgegebenen Texts beurteilt werden.

Kompatibilitätsbereich

Diese Seite behandelt das Erstellen von Antworten und das Lesen von Text. Leite daraus nicht ab, dass alle Fähigkeiten wie Hintergrundaufträge, Abruf früherer Antworten, previous_response_id, verwaltete Tools, Dateispeicherung usw. verfügbar sind. Wenn eine Sitzungsfortsetzung erforderlich ist, zuerst mit expliziter Verlaufseingabe verifizieren; bei bestimmten Tools je Modell und Client einzeln verifizieren.

Für die Konfiguration fertiger Tools siehe Codex CLI. SDK-Verwendung siehe OpenAI Python SDK.