Interface Responses

Use a interface Responses da OpenAI para acessar 1折AI, entendendo input, output, eventos de streaming e limites de compatibilidade.

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

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

Antes de executar, defina ONEZHE_API_KEY e confirme que o modelo está na sua lista de disponibilidade . 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:

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)

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 .

Leitura em streaming

Após inicializar o client acima, use:

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

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 . Para referência de uso do SDK, consulte OpenAI Python SDK .