> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 자주 묻는 질문

> ElkAPI 사용에 관한 자주 묻는 질문

## 연결 및 사용

### ElkAPI 서비스에 연결할 수 없나요?

ElkAPI 서비스에 연결할 수 없는 경우 다음을 확인하세요:

* API Key가 올바르게 구성되었는지 확인
* 네트워크 연결이 정상인지 확인
* API 엔드포인트 주소가 올바른지 확인: `https://api.elkapi.com`
* 방화벽 또는 프록시 설정이 연결을 차단하지 않는지 확인

### 모델 선택 후 응답이 없거나 오류가 발생하나요?

다음과 같은 이유일 수 있습니다:

* API Key가 올바르게 구성되지 않았거나 만료됨
* 선택한 모델이 일시적으로 사용할 수 없음
* 요청 형식이 올바르지 않음
* 계정 잔액 부족

[ElkAPI 대시보드](https://api.elkapi.com)에서 계정 상태와 API 키를 확인하세요.

### 대화 오류나 중단이 발생하면 어떻게 하나요?

대화 오류가 발생한 경우:

* 오류 메시지의 구체적인 정보 확인
* 요청 매개변수가 API 사양을 준수하는지 확인
* API 문서에서 올바른 요청 형식 확인
* 문제가 지속되면 기술 지원에 문의

## 계정 관리

### API 사용량과 비용을 어떻게 확인하나요?

다음 방법으로 사용량과 비용을 확인할 수 있습니다:

1. [ElkAPI 대시보드](https://api.elkapi.com)에 로그인
2. 콘솔에서 사용 통계 확인
3. 상세한 호출 기록 및 요금 명세 확인

### 기술 지원을 받으려면 어떻게 하나요?

기술 지원이 필요한 경우 다음 방법으로 문의하세요:

* WeChat 고객 서비스 추가 (대시보드 QR 코드 스캔)
* 기술 지원 팀에 이메일 전송

## 보안 및 구성

### API Key를 관리하고 보호하는 방법은?

API Key 보안을 보호하세요:

* 공개 코드 저장소에 API Key를 커밋하지 마세요
* 환경 변수를 사용하여 API Key 저장
* 정기적으로 API Key 교체
* API Key가 유출되면 대시보드에서 즉시 재생성

## 기능 및 특징

### 어떤 AI 모델이 지원되나요?

ElkAPI는 다양한 주요 AI 모델을 지원합니다:

* **텍스트 모델**: GPT-5, Claude, Gemini 등
* **이미지 모델**: GPT-Image, Gemini-3.1-Flash-Image-preview 등
* **비디오 모델**: VEO 3.1, Wan 2.7 등
* **오디오 모델**: TTS 등

지원되는 특정 모델은 [API 문서](/ko/index)를 확인하세요.

### OpenAI API와의 호환성은 어떤가요?

ElkAPI는 OpenAI API 형식과 완벽하게 호환됩니다:

* API 엔드포인트를 직접 교체 가능
* 동일한 요청 형식 사용
* 기존 코드를 수정할 필요 없음
* 모든 주요 OpenAI API 기능 지원

### API 응답이 공식 웹 버전(ChatGPT, Claude 등)과 다른 이유는?

동일한 기본 모델을 사용하지만 공식 웹 버전과 API 호출 간에는 차이가 있습니다:

**공식 웹 버전**은 광범위한 엔지니어링 최적화 및 향상된 기능을 포함합니다:

* 실시간 정보 검색을 위한 내장 인터넷 검색
* 컨텍스트를 자동으로 연결하는 대화 메모리
* 내장 계산기 및 코드 실행 환경
* 사전 구성된 시스템 프롬프트
* 최적화된 사용자 인터페이스

**API 호출**은 원시 모델 기능을 제공합니다:

* 핵심 추론 및 생성 능력만 제공
* 개발자가 대화 기록을 수동으로 관리해야 함
* 시스템 프롬프트 및 컨텍스트의 수동 구성 필요
* 도구 호출(Function Calling)의 자체 통합 필요

<Tip>
  **개발 팁**: API를 사용할 때는 시스템 프롬프트(system message)를 적극적으로 구성하고, 대화 기록을 유지하며, 필요에 따라 도구 호출 기능을 통합하여 웹 버전에 가까운 경험을 구현할 수 있습니다.
</Tip>

## 비용 최적화

### API 호출 비용을 최적화하는 방법은?

비용 최적화를 위한 제안:

* 필요에 맞는 모델 선택 (모델마다 가격이 다름)
* 스트리밍 응답을 사용하여 대기 시간 단축
* 합리적인 토큰 제한 설정
* 일반적인 응답 캐싱
* 사용량 모니터링하여 예상치 못한 소비 방지

***

다른 질문이 있으시면 커뮤니티 토론에 참여하거나 기술 지원에 문의하세요.