Interfaz de Responses

Documentación mantenida por 1ZheAI. Fuentes y correcciones.

¿Encontraste un error? Contacta con soporte indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

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. 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.

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. Para el uso del SDK, consulta OpenAI Python SDK.