---
title: "Responses-Schnittstelle"
description: "Verbinde dich über die OpenAI Responses-Schnittstelle mit 1折AI und verstehe Input, Output, Streaming-Ereignisse und Kompatibilitätsgrenzen."
headingIds: {"Minimalanfrage":"section-1","Unterschiede zu Chat Completions":"section-2","Python SDK":"section-3","Streaming-Lesen":"section-4","Kompatibilitätsbereich":"section-5"}
---

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

Dokumentation gepflegt von [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Quellen und Korrekturen](https://1zheai.com/en/editorial/).

Fehler gefunden? [Support kontaktieren](mailto:support@1zheai.com) mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

</aside>
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

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

Vor dem Ausführen `ONEZHE_API_KEY` setzen und sicherstellen, dass das Modell in [deiner verfügbaren Liste](/de/docs/api-models/) 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`:

```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)
```

Hier wird automatisches Wiederholen deaktiviert, um die erste Integration bei einer einzelnen Anfrage zu erleichtern. Vor dem Produktivbetrieb die Strategie gemäß [Timeout und Wiederholen](/de/docs/retries/) einstellen.

## Streaming-Lesen

Nach dem oben initialisierten `client` verwenden:

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

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](/de/docs/quickstart-codex/). SDK-Verwendung siehe [OpenAI Python SDK](https://github.com/openai/openai-python).