---
title: "Interfaz de Responses"
description: "Conecta 1折AI mediante la interfaz de Responses de OpenAI; conoce el input, el output, los eventos en streaming y los límites de compatibilidad."
headingIds: {"Solicitud mínima":"section-1","Diferencias con Chat Completions":"section-2","SDK de Python":"section-3","Lectura en streaming":"section-4","Alcance de compatibilidad":"section-5"}
---

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

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
Codex CLI utiliza el protocolo Responses. Al escribir tu propia aplicación, también puedes solicitar modelos GPT compatibles con esta interfaz a través de `POST https://1zheai.com/v1/responses`. En el Base URL del SDK de OpenAI, introduce `https://1zheai.com/v1`.

## Solicitud mínima

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

Antes de ejecutar, define `ONEZHE_API_KEY` y verifica que el modelo figure en [tu lista de modelos disponibles](/es/docs/api-models/). `store: false` es una opción de almacenamiento del protocolo; no significa que todos los niveles de servicio carezcan de registros o retención de datos; no infieras compromisos de privacidad a partir de ello.

## Diferencias con Chat Completions

| Contenido | Chat Completions | Responses |
| --- | --- | --- |
| Entrada | `messages` | `input`, que puede ser una cadena o elementos de entrada estructurados |
| Resultado de texto | `choices[].message.content` | Bloques de contenido de mensaje en `output` |
| Atributos auxiliares de texto del SDK | Extraer la opción por tu cuenta | `response.output_text` |
| Texto en streaming | `choices[].delta.content` | Eventos `response.output_text.delta` |
| Determinación de finalización | `finish_reason` y fin del stream | Comprobar el estado de la respuesta y el evento de terminación |

`output_text` es un atributo de conveniencia proporcionado por el SDK; no asumas que este campo exista en el nivel superior del JSON HTTP original. Al llamar directamente a HTTP, recorre `output`, selecciona `type: message` y luego lee el `text` de `type: output_text` en su `content`.

## SDK de Python

Después de instalar `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)
```

Aquí se desactivan los reintentos automáticos para facilitar la localización de una única solicitud durante la primera integración. Antes de publicar, configura la política según [tiempos de espera y reintentos](/es/docs/retries/).

## Lectura en streaming

Úsalo después de inicializar `client` arriba:

```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 se desconecta sin recibir el evento de finalización, marca el resultado como incompleto; no juzgues el éxito únicamente por el texto ya emitido.

## Alcance de compatibilidad

Esta página cubre la creación de respuestas y la lectura de texto. No infieras de ello que todas las capacidades —tareas en segundo plano, recuperación de respuestas históricas, `previous_response_id`, herramientas alojadas, almacenamiento de archivos, etc.— estén disponibles. Cuando necesites continuar una sesión, valida primero con una entrada de historial explícita; cuando necesites una herramienta concreta, valida caso por caso según el modelo y el cliente.

Para configurar herramientas preexistentes, consulta [Codex CLI](/es/docs/quickstart-codex/). Para el uso del SDK, consulta [OpenAI Python SDK](https://github.com/openai/openai-python).