---
title: "Interface Responses"
description: "Use a interface Responses da OpenAI para acessar 1折AI, entendendo input, output, eventos de streaming e limites de compatibilidade."
headingIds: {"Requisição mínima":"section-1","Diferenças em relação ao Chat Completions":"section-2","SDK Python":"section-3","Leitura em streaming":"section-4","Escopo de compatibilidade":"section-5"}
---

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

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
O Codex CLI usa o protocolo Responses. Ao desenvolver seu próprio aplicativo, você também pode solicitar modelos GPT que suportam essa interface via `POST https://1zheai.com/v1/responses`. Preencha a Base URL do SDK da OpenAI com `https://1zheai.com/v1`.

## Requisição 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 executar, defina `ONEZHE_API_KEY` e confirme que o modelo está na [sua lista de disponibilidade ](/pt/docs/api-models/). `store: false` é uma opção de armazenamento do protocolo e não significa que todos os níveis de serviço não tenham logs ou retenção de dados; não faça inferências de compromissos de privacidade com base nisso.

## Diferenças em relação ao Chat Completions

| Conteúdo | Chat Completions | Responses |
| --- | --- | --- |
| Entrada | `messages` | `input`, pode ser uma string ou itens de entrada estruturados |
| Resultado em texto | `choices[].message.content` | blocos de conteúdo de message em `output` |
| Atributos auxiliares de texto do SDK | extraia você mesmo o choice | `response.output_text` |
| Texto em streaming | `choices[].delta.content` | eventos `response.output_text.delta` |
| Determinação de término | `finish_reason` e fim do stream | verifique o status da resposta e o evento de término |

`output_text` é um atributo de conveniência fornecido pelo SDK; não assuma que esse campo exista no nível superior do JSON bruto da HTTP. Ao chamar a HTTP diretamente, percorra `output`, selecione `type: message` e leia o `text` de `type: output_text` em `content`.

## SDK Python

Após 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)
```

Aqui o retry automático está desativado, o que facilita a localização de uma única requisição na primeira integração. Antes de ir para produção, defina a política conforme [timeout e retry ](/pt/docs/retries/).

## Leitura em streaming

Após inicializar o `client` acima, use:

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

Se a conexão for encerrada sem receber o evento de conclusão, o resultado deve ser marcado como incompleto; não se deve julgar o sucesso apenas com base no texto já emitido.

## Escopo de compatibilidade

Esta página cobre a criação de respostas e a leitura de texto. Não infira a partir daqui que capacidades como tarefas em segundo plano, recuperação de respostas anteriores, `previous_response_id`, ferramentas gerenciadas, armazenamento de arquivos etc. estejam totalmente disponíveis. Quando precisar de continuação de sessão, valide primeiro com entrada de histórico explícito; quando precisar de ferramentas específicas, valide item a item conforme o modelo e o cliente.

Para configurar ferramentas prontas, consulte [Codex CLI ](/pt/docs/quickstart-codex/). Para referência de uso do SDK, consulte [OpenAI Python SDK ](https://github.com/openai/openai-python).