Interface Responses

Connectez 1折AI via l'interface Responses d'OpenAI, et comprenez l'input, l'output, les événements de streaming et les limites de compatibilité.

Codex CLI utilise le protocole Responses. Lorsque vous écrivez votre propre application, vous pouvez également demander les modèles GPT prenant en charge cette interface via POST https://1zheai.com/v1/responses. Renseignez l’URL de base du SDK OpenAI avec https://1zheai.com/v1.

Requête minimale

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

Avant l’exécution, définissez ONEZHE_API_KEY et vérifiez que le modèle figure dans votre liste des modèles disponibles . store: false est une option de stockage du protocole ; cela ne signifie pas que tous les niveaux de service sont exempts de journaux ou de conservation des données ; n’en déduisez pas d’engagement de confidentialité.

Différences avec Chat Completions

Élément	Chat Completions	Responses
Entrée	`messages`	`input`, pouvant être une chaîne ou des éléments d’entrée structurés
Résultat textuel	`choices[].message.content`	Bloc de contenu message dans `output`
Attribut d’aide textuel du SDK	Extraction manuelle du choix	`response.output_text`
Texte en streaming	`choices[].delta.content`	Événements `response.output_text.delta`
Détection de fin	`finish_reason` et fin du flux	Vérifiez l’état de la réponse et l’événement de terminaison

output_text est un attribut de commodité fourni par le SDK ; ne supposez pas que ce champ existe au premier niveau du JSON HTTP brut. Lors d’un appel HTTP direct, parcourez output, sélectionnez type: message, puis lisez la text de type: output_text dans son content.

SDK Python

Après l’installation de 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)

Ici, la reprise automatique est désactivée afin de faciliter l’identification d’une requête unique lors de la première intégration. Avant la mise en production, définissez la stratégie selon les délais d’attente et les tentatives .

Lecture en streaming

À utiliser après l’initialisation de client ci-dessus :

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

Si la connexion est interrompue sans réception de l’événement de complétion, le résultat doit être marqué comme incomplet ; le succès ne peut être déduit uniquement du texte déjà affiché.

Portée de compatibilité

Cette page couvre la création de réponses et la lecture de texte. N’en déduisez pas que toutes les fonctionnalités telles que les tâches en arrière-plan, la récupération des réponses passées, previous_response_id, les outils hébergés, le stockage de fichiers, etc. sont disponibles. Pour la reprise de session, validez d’abord avec un historique d’entrée explicite ; pour un outil spécifique, validez item par item selon le modèle et le client.

Pour configurer les outils prêts à l’emploi, consultez Codex CLI . Pour l’utilisation du SDK, consultez OpenAI Python SDK .