---
title: "Interface Responses"
description: "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é."
headingIds: {"Requête minimale":"section-1","Différences avec Chat Completions":"section-2","SDK Python":"section-3","Lecture en streaming":"section-4","Portée de compatibilité":"section-5"}
---

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

Documentation maintenue par [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources et corrections](https://1zheai.com/en/editorial/).

Vous avez trouvé une erreur ? [Contactez l'assistance](mailto:support@1zheai.com) en indiquant l'adresse de la page et une description. N'envoyez pas de clés API ni d'identifiants de compte.

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

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

Avant l'exécution, définissez `ONEZHE_API_KEY` et vérifiez que le modèle figure dans [votre liste des modèles disponibles ](/fr/docs/api-models/). `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` :

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

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 ](/fr/docs/retries/).

## Lecture en streaming

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

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

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 ](/fr/docs/quickstart-codex/). Pour l'utilisation du SDK, consultez [OpenAI Python SDK ](https://github.com/openai/openai-python).