---
title: "API 접속 자주 묻는 질문"
description: "Base URL, 모델, 스트리밍, 클라이언트, 타임아웃 및 가용성 모니터링에 대한 자주 묻는 질문을 빠르게 찾아보세요."
headingIds: {"주소, 키 및 모델":"section-1","요청 및 클라이언트":"section-2","서비스 상태 및 도움말":"section-3"}
---

<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>
## 주소, 키 및 모델

<AccordionGroup>
<Accordion title="Base URL에 /v1을 포함해야 하나요?">

OpenAI SDK에는 `https://1zheai.com/v1`을(를) 입력하고, Anthropic SDK와 Claude Code에는 `https://1zheai.com`을(를) 입력합니다. curl을 직접 사용할 때는 전체 요청 경로를 입력합니다. 일부 데스크톱 도구는 경로를 자동으로 완성하므로 [주소 대조표](/ko/docs/base-url/)을(를) 참조하세요.

</Accordion>
<Accordion title="ChatGPT 또는 Claude 구독이 있으면 본 사이트 키가 필요한가요?">

필요합니다. 본 사이트 접속에는 본 사이트 콘솔에서 생성한 API 키를 사용해야 하며, 소비자용 클라이언트의 구독은 본 사이트 API 자격 증명과는 별개의 접속 방식입니다. 도구도 사용자 지정 공급자 또는 API 주소를 지원해야 합니다.

</Accordion>
<Accordion title="모델 목록에 있는데 왜 호출이 실패하나요?">

목록에 표시되는 것은 현재 키로 볼 수 있는 모델이며, 실시간 추론 성공률이 아닙니다. 인터페이스 프로토콜, 선택적 파라미터 및 업스트림 상태도 함께 확인해야 합니다. [모델 조회 인터페이스](/ko/docs/api-models/)을(를) 참조하세요.

</Accordion>
<Accordion title="다른 플랫폼의 모델 이름을 그대로 사용할 수 있나요?">

본 사이트 모델 목록에서 전체 ID를 복사하세요. 공급자에 따라 접두사, 별칭 및 날짜 버전이 다를 수 있으므로 추측으로 이름을 바꾸지 마세요. 마이그레이션 단계는 [마이그레이션 가이드](/ko/docs/migration/)을(를) 참조하세요.

</Accordion>
</AccordionGroup>

## 요청 및 클라이언트

<AccordionGroup>
<Accordion title="호출은 성공했는데 텍스트를 받을 수 없음?">

먼저 응답 프로토콜을 확인하세요. Chat Completions는 `choices[].message.content`을(를) 읽고, Messages는 `content` 텍스트 블록을 순회하며, Responses는 `output`을(를) 순회하거나 SDK의 `output_text`을(를) 사용합니다. 도구 호출 응답에는 일반 텍스트가 없을 수도 있습니다.

</Accordion>
<Accordion title="이전 대화 내용이 기억되지 않나요?">

다중 대화는 클라이언트가 히스토리를 전달해야 합니다. 동일한 키를 반복 사용해도 서버 측 세션이 자동으로 생성되지 않습니다. Responses의 세션 관련 확장은 별도로 지원 여부를 확인해야 하며, 기본적으로 의존하지 마세요.

</Accordion>
<Accordion title="스트리밍으로 텍스트를 받았으면 성공인가요?">

종료 이벤트 또는 최종 상태도 확인해야 합니다. 중간 오류, 스트림 끊김 및 출력 잘림은 일부 텍스트를 이미 수신한 후에도 발생할 수 있습니다. 자세한 내용은 [스트리밍 출력](/ko/docs/streaming/)을(를) 참조하세요.

</Accordion>
<Accordion title="타임아웃 후 계속 재시도할 수 있나요?">

권장하지 않습니다. 타임아웃은 요청이 이미 처리된 후에도 발생할 수 있습니다. 먼저 호출 로그를 확인한 다음, 제한된 횟수, 백오프 및 총 대기 시간에 따라 재시도를 실행하세요. SDK와 애플리케이션이 각각 한 번씩 재시도하지 않도록 주의하세요. [타임아웃 및 재시도](/ko/docs/retries/)을(를) 참조하세요.

</Accordion>
<Accordion title="API 키를 웹 프론트엔드에 직접 넣을 수 있나요?">

키를 브라우저 스크립트나 공개 저장소에 컴파일하지 마세요. 서버가 자격 증명을 보유하고 인터페이스를 호출하게 하고, 브라우저는 자신의 백엔드에만 연결해야 합니다. 데모 코드의 환경 변수는 서버 또는 로컬 터미널용입니다.

</Accordion>
</AccordionGroup>

## 서비스 상태 및 도움말

<AccordionGroup>
<Accordion title="가동 시간 모니터링은 정상인데 왜 모델에 오류가 나나요?">

모니터링은 공식 웹사이트, 콘솔 및 API 진입점의 HTTP 접근성을 확인하며, 각 모델의 추론 성공률을 의미하지는 않습니다. 모니터링은 애플리케이션과 동일한 서버에 배포되므로 서버 전체 장애 시 모니터링도 중단됩니다. 이력 데이터는 활성화 후부터 누적됩니다.

</Accordion>
<Accordion title="지원팀에 문의할 때 무엇을 준비해야 하나요?">

발생 시각과 시간대, 클라이언트 버전, 모델 ID, 전체 요청 경로, HTTP 상태 코드, 요청 ID 및 마스킹된 오류 정보를 제공하세요. 키, 인증 헤더 및 개인 대화 내용은 삭제하세요. [디버깅 템플릿](/ko/docs/troubleshooting/)에 따라 정리할 수 있습니다.

</Accordion>
</AccordionGroup>