---
title: "Responses 인터페이스"
description: "OpenAI Responses를 통해 1折AI에 접속하여 input, output, 스트리밍 이벤트 및 호환 범위를 알아봅니다."
headingIds: {"최소 요청":"section-1","Chat Completions과의 차이":"section-2","Python SDK":"section-3","스트리밍 읽기":"section-4","호환 범위":"section-5"}
---

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

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

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

## 최소 요청

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

실행 전에 `ONEZHE_API_KEY`을 설정하고, 모델이 [사용 가능한 목록](/ko/docs/api-models/)에 있는지 확인하세요. `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` 설치 후:

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

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

## 스트리밍 읽기

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

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

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

## 호환 범위

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

기성 도구 구성은 [Codex CLI](/ko/docs/quickstart-codex/)을 참조하세요. SDK 사용법은 [OpenAI Python SDK](https://github.com/openai/openai-python)을 참조하세요.