소개
Gemini CLI는 Google이 제공하는 공식 명령줄 도구로, 개발자가 터미널에서 Gemini AI 모델과 상호작용할 수 있게 합니다. APIMart API를 구성하면 GPT, Claude, Gemini 시리즈를 포함한 APIMart가 제공하는 다양한 고급 AI 모델을 Gemini CLI에서 사용할 수 있습니다.준비사항
시작하기 전에 다음을 확인하세요:-
Node.js와 npm 설치
Node.js 공식 웹사이트에서 다운로드하여 설치 (v16 이상 권장) -
APIMart API 키
APIMart 콘솔에 로그인하여 API 키 획득 (sk-로 시작)
팁: APIMart 계정이 아직 없다면 먼저 APIMart에서 등록하고 API 키를 받으세요.
1단계: Gemini CLI 설치
1.1 전역 설치
npm을 사용하여 Gemini CLI를 전역으로 설치합니다:1.2 설치 확인
설치가 성공했는지 확인합니다:팁: 명령을 사용할 수 없는 경우 터미널을 재시작하거나 npm 전역 경로 설정을 확인하세요.
2단계: APIMart API 구성
2.1 임시 환경 변수 설정
테스트 또는 일회성 사용에 적합하며, 터미널을 닫으면 만료됩니다: Windows (PowerShell):2.2 영구 환경 변수 설정 (권장)
시스템에 구성을 작성하여 터미널 세션마다 자동으로 적용됩니다: Windows (PowerShell):- 관리자 권한으로 PowerShell 실행
- 다음 명령을 실행하여 사용자 수준 환경 변수 설정:
- PowerShell을 재시작하거나 다음 명령을 실행하여 환경 변수 새로 고침:
- 구성 파일 편집 (사용하는 셸에 따라 선택):
- 파일 끝에 다음 내용 추가:
- 파일을 저장하고 구성 다시 로드:
2.3 .env 파일 사용
프로젝트 디렉토리에.env 파일 생성:
중요 사항:
sk-xxxxxxxxxxxx를 APIMart 콘솔에서 받은 실제 API 키로 교체하세요GEMINI_BASE_URL을https://api.apimart.ai/v1로 설정하여 Gemini CLI가 APIMart에 연결되도록 합니다.env파일을 사용하는 경우 API 키 노출을 방지하기 위해.gitignore에 추가하세요
2.4 구성 확인
환경 변수가 올바르게 설정되었는지 확인: macOS/Linux:3단계: Gemini CLI 사용 시작
3.1 기본 대화
대화형 채팅 시작:3.2 모델 지정
특정 모델로 대화:3.3 파일에서 프롬프트 읽기
파일에서 프롬프트 읽기:3.4 출력을 파일로 저장
AI 응답을 파일로 저장:4단계: 코드에서 APIMart 사용
자체 코드에서 APIMart API를 사용하려면:4.1 Python SDK 사용
4.2 JavaScript/TypeScript 사용
4.3 cURL 사용
5단계: 적절한 모델 선택
추천 모델
APIMart는 다양한 모델을 지원하며, 필요에 따라 선택할 수 있습니다: Gemini 시리즈:| 모델명 | 모델 ID | 특징 | 적용 시나리오 |
|---|---|---|---|
| Gemini 2.0 Flash | gemini-2.0-flash-exp | 빠른 속도, 멀티모달 | 빠른 응답, 이미지-텍스트 이해 |
| Gemini 2.5 Pro | gemini-2.5-pro | 강력한 성능 | 복잡한 작업, 전문 분석 |
| Gemini 2.5 Flash | gemini-2.5-flash | 고속 응답 | 실시간 상호작용, 배치 처리 |
| 모델명 | 모델 ID | 특징 | 적용 시나리오 |
|---|---|---|---|
| GPT-5 | gpt-5 | 최신 최강 | 복잡한 추론, 창의적 작성 |
| GPT-4o | gpt-4o | 고품질 | 일상 대화, 콘텐츠 생성 |
| GPT-4o Mini | gpt-4o-mini | 경제적 | 간단한 작업, 고빈도 사용 |
| 모델명 | 모델 ID | 특징 | 적용 시나리오 |
|---|---|---|---|
| Claude Sonnet 4.5 | claude-sonnet-4-5-20250929 | 강력한 추론 능력 | 코드 생성, 논리 분석 |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 | 초고속 | 빠른 Q&A, 실시간 대화 |
고급 기능
멀티모달 지원
멀티모달을 지원하는 모델(예: Gemini 2.0 Flash)로 이미지 처리:스트리밍 출력
실시간 스트리밍 응답 받기:매개변수 조정
모델 출력 최적화:자주 묻는 질문
Q1: API 키가 유효하지 않다고 표시됩니까?
해결 방법:-
API Key 형식 확인:
- API Key가
sk-로 시작하는지 확인 - 완전히 복사되었고 여분의 공백이 없는지 확인
- API Key가
-
환경 변수 확인:
-
키 유효성 확인:
- APIMart 콘솔에서 키 상태 확인
- 계정에 충분한 잔액이 있는지 확인
Q2: API 구성이 올바른지 확인하는 방법은?
테스트 방법:Q3: 어떤 프로그래밍 언어가 지원됩니까?
APIMart API는 HTTP 요청을 보낼 수 있는 모든 프로그래밍 언어를 지원합니다:- ✅ Python - OpenAI SDK 사용 권장
- ✅ JavaScript/TypeScript - Node.js 및 브라우저 환경
- ✅ Java - HTTP 클라이언트 사용
- ✅ Go - 표준 라이브러리 또는 타사 패키지
- ✅ PHP - cURL 또는 Guzzle
- ✅ Ruby - HTTP 라이브러리
- ✅ C#/.NET - HttpClient
- ✅ Swift - URLSession
- ✅ 기타 언어 - HTTP를 지원하는 모든 언어
Q4: API 사용량을 확인하는 방법은?
APIMart 콘솔에 로그인하여 확인:- 📊 실시간 호출 통계
- 💰 비용 상세 및 청구서
- 📈 사용 트렌드 차트
- 🔍 상세한 요청 로그
- ⚙️ API 키 관리
Q5: API 오류가 발생하면 어떻게 하나요?
일반적인 오류 및 해결책:| 오류 코드 | 원인 | 해결 방법 |
|---|---|---|
401 Unauthorized | API Key가 유효하지 않음 | API Key가 올바른지 확인 |
429 Too Many Requests | 요청이 너무 빈번함 | 요청 빈도를 낮추거나 플랜 업그레이드 |
500 Internal Server Error | 서버 오류 | 나중에 다시 시도하거나 지원팀에 문의 |
insufficient_quota | 잔액 부족 | 콘솔에서 충전 |
모범 사례
1. 오류 처리
2. 비용 최적화
3. 프롬프트 최적화
기능 특징
Gemini CLI + APIMart를 사용하면 다음이 가능합니다:- 🤖 다중 모델 지원 - GPT, Claude, Gemini 등 여러 모델에 액세스
- 🌍 OpenAI 호환 - 표준 OpenAI API 형식 사용
- ⚡ 고성능 - 낮은 지연 시간, 높은 동시성 지원
- 💰 투명한 가격 - 명확한 종량제
- 📊 사용량 모니터링 - 실시간으로 API 호출 확인
- 🔒 안전하고 신뢰할 수 있음 - 엔터프라이즈급 보안
- 🚀 빠른 통합 - 간단한 API 호출 방법
- 📚 완전한 문서 - 상세한 개발 문서 및 예제
지원 및 도움말
사용 중 문제가 발생하면:- 📚 APIMart 문서 센터
- 📚 Gemini CLI 문서
- 💬 Discord 커뮤니티
- 🐦 Twitter @APIMart_
- 📧 기술 지원: zhihong@apimart.ai
APIMart 시작하기
지금 APIMart에 등록하고 API 키를 받아 Gemini CLI에서 다양한 AI 모델을 사용하세요!