Responses 인터페이스

OpenAI Responses를 통해 1折AI에 접속하여 input, output, 스트리밍 이벤트 및 호환 범위를 알아봅니다.

Codex CLI는 Responses 프로토콜을 사용합니다. 직접 애플리케이션을 작성할 때도 POST https://1zheai.com/v1/responses을 통해 해당 인터페이스를 지원하는 GPT 모델에 요청할 수 있습니다. OpenAI SDK Base URL에는 https://1zheai.com/v1을 입력합니다.

최소 요청

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

실행 전에 ONEZHE_API_KEY을 설정하고, 모델이 사용 가능한 목록에 있는지 확인하세요. store: false은 프로토콜의 저장 옵션이며, 모든 서비스 계층에 로그나 데이터 보존이 없다는 의미가 아닙니다. 이를 근거로 개인정보 보호 약속을 추론하지 마세요.

Chat Completions과의 차이

항목	Chat Completions	Responses
입력	`messages`	`input`, 문자열 또는 구조화된 입력 항목 가능
텍스트 결과	`choices[].message.content`	`output`의 message 콘텐츠 블록
SDK 텍스트 보조 속성	choice를 직접 추출	`response.output_text`
스트리밍 텍스트	`choices[].delta.content`	`response.output_text.delta` 이벤트
종료 판단	`finish_reason` 및 스트림 종료	응답 상태 및 종료 이벤트 확인

output_text은 SDK가 제공하는 편의 속성이므로, 원시 HTTP JSON 최상위에 이 필드가 존재한다고 가정하지 마세요. HTTP를 직접 호출할 때는 output을 순회하여 type: message을 선택한 후, 해당 content에서 type: output_text의 text을 읽으세요.

Python SDK

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)

여기서 자동 재시도를 비활성화하여, 최초 접속 시 단일 요청을 추적하기 쉽게 했습니다. 출시 전에 타임아웃 및 재시도에 따라 정책을 설정하세요.

스트리밍 읽기

위에서 초기화한 client 뒤에 사용합니다:

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

완료 이벤트를 받지 못하고 연결이 끊긴 경우, 결과를 미완료로 표시해야 하며, 이미 출력된 텍스트만으로 성공을 판단할 수 없습니다.

호환 범위

이 페이지는 응답 생성 및 텍스트 읽기를 다룹니다. 이를 근거로 백그라운드 작업, 과거 응답 검색, previous_response_id, 관리형 도구, 파일 저장소 등의 기능이 모두 사용 가능하다고 추론하지 마세요. 세션 이어가기가 필요하면 명시적 과거 입력으로 먼저 검증하고, 특정 도구가 필요하면 모델과 클라이언트별로 항목별로 검증하세요.

기성 도구 구성은 Codex CLI을 참조하세요. SDK 사용법은 OpenAI Python SDK을 참조하세요.