API 접속 자주 묻는 질문

Base URL, 모델, 스트리밍, 클라이언트, 타임아웃 및 가용성 모니터링에 대한 자주 묻는 질문을 빠르게 찾아보세요.

주소, 키 및 모델

Base URL에 /v1을 포함해야 하나요?

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

ChatGPT 또는 Claude 구독이 있으면 본 사이트 키가 필요한가요?

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

모델 목록에 있는데 왜 호출이 실패하나요?

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

다른 플랫폼의 모델 이름을 그대로 사용할 수 있나요?

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

요청 및 클라이언트

호출은 성공했는데 텍스트를 받을 수 없음?

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

이전 대화 내용이 기억되지 않나요?

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

스트리밍으로 텍스트를 받았으면 성공인가요?

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

타임아웃 후 계속 재시도할 수 있나요?

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

API 키를 웹 프론트엔드에 직접 넣을 수 있나요?

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

서비스 상태 및 도움말

가동 시간 모니터링은 정상인데 왜 모델에 오류가 나나요?

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

지원팀에 문의할 때 무엇을 준비해야 하나요?

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