API 호출 방법과 API 플랫폼 선택 가이드

지금까지 API, 토큰, Temperature 같은 핵심 개념을 다뤘습니다. 이제 실전입니다: 실제로 API를 호출하는 방법은?

많은 사람들이 API를 신비롭게 생각하지만, 몇 가지 핵심 요소만 알면 API 호출은 온라인 쇼핑만큼 간단합니다. 이 장에서 단계별로 안내해 드리겠습니다.

API 호출의 세 가지 핵심 요소

어떤 도구나 플랫폼을 사용하든 AI API를 호출하려면 다음 세 가지가 필요합니다.

1. API Key

API Key = 당신의 신분증

은행에서 돈을 찾으려면 카드 비밀번호가 필요하듯, API를 호출하려면 API Key가 필요합니다. “이게 나야, 나를 서비스해 줘"라고 증명하는 역할을 합니다.

API Key는 어떻게 생겼나요?

보통 긴 문자열(영문자와 숫자)로 구성됩니다. 예:

sk-REPLACE_WITH_YOUR_API_KEY

중요 알림:

• API Key는 비공개입니다. 다른 사람과 공유하지 마세요.
• 누군가 당신의 키를 알면 그 사람이 당신 계정으로 API를 호출할 수 있습니다(당신의 비용이 소모됩니다).
• 실수로 유출했다면 즉시 플랫폼에서 기존 키를 삭제하고 새 키를 생성하세요.

2. Base URL

Base URL = 식당 주소

배달 음식을 주문할 때 식당 위치를 알아야 하듯, API를 호출할 때는 서버 위치를 알아야 합니다.

일반적인 Base URL:

• OpenAI: https://api.openai.com/v1
• Anthropic Claude: https://api.anthropic.com/v1
• Google Gemini: https://generativelanguage.googleapis.com/v1
• DeepSeek: https://api.deepseek.com/v1

서드파티 플랫폼은 URL이 다르지만 형식은 비슷합니다.

3. Model Name

Model Name = 주문할 요리 이름

식당에서 “돼지고기 찜 주세요"라고 말하듯, API 호출 시 “GPT-5.2를 사용할게요"라고 말합니다.

일반적인 Model Name:

• OpenAI: gpt-5.2, gpt-5.2-chat-latest
• Claude: claude-opus-4.5, claude-sonnet-4.5
• Gemini: gemini-3-pro, gemini-3-flash
• DeepSeek: deepseek-chat, deepseek-coder

완전한 API 호출 예시

이 세 가지를 조합하면 가장 간단한 API 호출은 다음과 같습니다.

import openai

# 1. Set the API Key
openai.api_key = "sk-proj-YOUR_API_KEY"

# 2. Set the Base URL (if you use a third-party platform)
openai.base_url = "https://api.openai.com/v1"

# 3. Call the selected model
response = openai.chat.completions.create(
    model="gpt-5.2",  # Model Name
    messages=[
        {"role": "user", "content": "Hello"}
    ]
)

print(response.choices[0].message.content)

복잡해 보이나요? 걱정 마세요. 나중에 소개할 플랫폼들은 더 간단한 방법을 제공합니다.

공식 API vs 서드파티 플랫폼

구체적인 플랫폼을 소개하기 전에 중요한 개념을 명확히 하겠습니다: 공식 API와 서드파티 플랫폼의 차이는 무엇인가요?

공식 API

공식 API = OpenAI, Anthropic, Google에서 직접 구매

장점:

• 안정성 최고, 공식 서버에 직접 연결
• 모든 기능 제공, 새로운 기능 즉시 지원
• 보안 최고, 데이터가 서드파티를 거치지 않음

단점:

• 해외 신용카드 필요
• VPN 필요 (ChatGPT, Claude, Gemini)
• 상대적으로 높은 가격
• 가입에 장벽이 있을 수 있음

서드파티 플랫폼

서드파티 플랫폼 = 리셀러에게 구매

서드파티 플랫폼은 먼저 공식으로부터 API 할당량을 구매한 후, 이를 다시 사용자에게 판매합니다.

장점:

• 국내 결제 지원 (Alipay, WeChat Pay, UnionPay)
• VPN 불필요
• 보통 한국어 인터페이스와 고객 지원 제공
• 하나의 플랫폼으로 여러 AI 호출 가능 (OpenAI, Claude, Gemini 등)
• 일부 플랫폼은 무료 크레딧 제공

단점:

• 안정성이 공식만큼 좋지 않을 수 있음
• 가격이 공식보다 약간 높을 수 있음 (일부는 더 저렴함)
• 보안은 플랫폼을 신뢰해야 함
• 기능 업데이트가 공식보다 늦을 수 있음

어떤 것을 선택해야 할까요?

다음 경우 공식 선택:

• 해외 신용카드가 있는 경우
• 안정적인 VPN이 있는 경우
• 데이터 보안을 중요시하는 경우
• 최신 기능이 필요한 경우

다음 경우 서드파티 선택:

• 해외 결제 수단이 없는 경우
• VPN이 없는 경우
• 국내 결제를 사용하고 싶은 경우
• 하나의 플랫폼으로 여러 AI를 호출하고 싶은 경우

플랫폼 추천 (국내 2개 + 해외 2개)

아래는 제가 추천하는 4가지 API 플랫폼입니다. 국내 2개, 해외 2개로 다양한 요구를 충족합니다.

1. DeepSeek 공식 (국내, 공식 플랫폼)

웹사이트: https://platform.deepseek.com

플랫폼 유형: 공식 플랫폼

추천 이유:

• 공식 플랫폼, 안정적이고 신뢰할 수 있음
• DeepSeek V3.2 성능이 GPT-5에 근접
• 중국 내 접속 빠름, VPN 불필요
• 간단한 가입, 전화번호만 있으면 됨
• 가격이 매우 저렴, 가성비 최고

API Key 받는 방법:

1. https://platform.deepseek.com 열기
2. 오른쪽 상단 “Login/Register” 클릭
3. 전화번호로 계정 등록
4. 로그인 후 왼쪽 “API Keys” 클릭
5. “Create API Key” 클릭
6. 키 복사 (한 번만 표시되므로 저장하세요)
7. 왼쪽 “Interface Documentation” 클릭하여 URL과 모델 이름 확인

호출 파라미터:

• Base URL: https://api.deepseek.com
• Model Name: deepseek-chat (채팅), deepseek-reasoner (추론)
• API Key: 방금 복사한 키

2. Volcano Engine (국내, 공식 플랫폼 + 서드파티)

웹사이트: https://console.volcengine.com/ark

플랫폼 유형: 공식 플랫폼 (ByteDance 소속)

추천 이유:

• ByteDance 공식 플랫폼, 안정적이고 신뢰할 수 있음
• Doubao 시리즈 모델 지원
• 국내 결제 지원 (Alipay, WeChat Pay, UnionPay)
• 가격 합리적, 가성비 좋음
• Doubao 자체 모델 외에도 DeepSeek V3.2, GLM 4.7 등 많은 국내 오픈소스 모델 호출 가능

사용 방법:

1. https://console.volcengine.com/ark 열기
2. 전화번호로 Volcano Engine 계정 등록
3. “Ark Large Model” 콘솔 진입
4. 실명 인증 완료 (신분증 필요)
5. “API Key Management” 클릭
6. 새 API 키 생성
7. 키 복사 및 저장
8. 왼쪽 “Activation Management” 클릭, 사용할 모델 선택
9. 새 페이지에서 필요한 모델 이름 복사 (참고: 같은 모델도 플랫폼에 따라 이름이 다를 수 있으니 주의)
10. Activation Management 페이지로 돌아와 상태가 “Activated"인지 확인, 아니면 오른쪽에서 모델 권한 활성화 클릭

호출 파라미터:

• Base URL: https://ark.cn-beijing.volces.com/api/v3
• Model Name: doubao-pro-32k, doubao-lite-32k 등
• API Key: 생성한 키

신규 사용자 혜택:

• 가입 시 무료 크레딧 제공
• 위 스크린샷 위에 표시된 활동에 참여하여 추가 무료 크레딧 획득 가능. 저는 매일 충분히 사용하고 있습니다.

3. Google AI Studio (해외, 공식 플랫폼)

웹사이트: https://aistudio.google.com

플랫폼 유형: 공식 플랫폼

추천 이유:

• Google 공식 플랫폼
• 무료 크레딧 제공 (제한 있음)
• Gemini 3 최고 수준 성능
• 안정적이고 신뢰할 수 있음
• 매우 긴 컨텍스트 지원 (200만 토큰)
• 웹 인터페이스에서 무료로 직접 사용 가능, 코딩 불필요

또한, 웹 버전을 무료로 사용하는 방법

코드를 작성하고 싶지 않다면 Google AI Studio는 매우 편리한 웹 채팅 인터페이스를 제공합니다. Gemini 3 Pro, Gemini 3 Flash 같은 모델을 직접 사용할 수 있습니다. 사실상 유료 Gemini 사용자와 같은 경험을 제공합니다.

사용 방법:

1. https://aistudio.google.com 열기
2. Google 계정으로 로그인 (VPN 필요)
3. 왼쪽 “Playground” 클릭
4. 오른쪽 상단에서 모델 선택:
   • gemini-3-pro: 최고 모델, 복잡한 작업에 적합
   • gemini-3-flash: 빠른 모델, 일상 대화에 적합
   • 기타 실험 모델도 있음
5. 입력창에 질문을 직접 입력하고 “Run” 클릭, AI가 답변

고급 기능 (웹 버전):

1. 파일 업로드

• 입력창 오른쪽 + 아이콘 클릭
• 이미지, PDF, 문서 등 업로드 가능
• 멀티모달 이해 지원

2. 파라미터 조정

• 오른쪽에서 앞서 소개한 파라미터 조정 가능
• 조정 가능 항목:
  • Temperature (창의성)
  • Top P
  • 최대 출력 토큰
  • 안전 설정

웹 버전의 장점:

• 코딩 불필요
• 소프트웨어 설치 불필요
• 브라우저에서 직접 사용
• 사용자 친화적 인터페이스, 모든 기능 제공
• 빠른 테스트 및 일상 사용에 적합

웹 버전은 누구를 위한 것인가요?

• 코딩을 전혀 모르는 완전 초보자
• Gemini의 성능을 빠르게 테스트하고 싶은 분
• 일상적인 채팅 및 질문
• 문서, 이미지 등 멀티모달 작업 처리

API Key 받기 (고급 사용자용)

본론으로 돌아와서, API Key를 받는 방법입니다.

API Key 받는 방법:

1. AI Studio 페이지에서 왼쪽 “Get API Key” 클릭
2. “Create API Key” 클릭
3. 생성된 API Key 복사
4. Playground로 돌아가 오른쪽에서 모델 이름 선택 및 복사

호출 파라미터:

• Base URL: https://generativelanguage.googleapis.com/v1beta
• Model Name: gemini-3-flash-preview
• API Key: 복사한 키

무료 티어 제한

중요! Google AI Studio는 기본적으로 무료 티어를 사용하며, 다음과 같은 제한이 있습니다 (2026년 1월 기준, 변경될 수 있음):

• 분당 요청 수 (RPM): 15
• 일일 요청 수 (RPD): 1500
• 분당 토큰 수 (TPM): 100만 토큰

자세한 제한 사항은 다음에서 확인: https://ai.google.dev/gemini-api/docs/rate-limits?hl=en

무료 티어로 충분한가요?

• 웹 채팅: 충분함
• 가끔 API 호출: 충분함
• 대량 자동 호출: 부족할 수 있음

제한을 없애는 방법? Cloud 크레딧 연결

Google Cloud는 신규 사용자에게 $10의 무료 크레딧을 제공합니다. 이를 AI Studio에 연결하면 더 높은 제한을 해제할 수 있습니다. Google Cloud 계정 설정 방법은 온라인에서 “Google Cloud free credits"를 검색하면 많은 튜토리얼이 있습니다. 여기서는 다루지 않겠습니다.

연결 방법:

1. AI Studio에서 API 인터페이스로 돌아가 “Set up billing” 클릭
2. 미리 생성한 Google Cloud 결제 계정 연결

연결 후 혜택:

• 속도 제한 대폭 증가 (RPM 최대 1000+)
• 무료 크레딧은 여전히 유효
• $10으로 강력한 flash 모델을 오래 사용 가능
• 웹 버전과 API 모두 더 높은 할당량 적용

4. OpenRouter (해외, 서드파티 플랫폼)

웹사이트: https://openrouter.ai

플랫폼 유형: 서드파티 플랫폼

추천 이유:

• 하나의 플랫폼으로 모든 주요 AI 호출 가능 (GPT, Claude, Gemini 등)
• 투명한 가격, 때로는 공식보다 저렴
• Alipay 결제 지원 (중국 사용자에게 친숙)
• 신용카드 및 암호화폐 결제 지원
• 무료 모델 체험 가능
• 거의 모든 사용 가능한 모델 호출 가능
• 순위가 신뢰할 만함

API Key 받는 방법:

1. https://openrouter.ai 열기
2. 오른쪽 상단 “Sign In” 클릭, Google 또는 GitHub로 로그인
3. 로그인 후 오른쪽 상단 아바타 클릭, “Keys” 선택
4. “Create Key” 클릭
5. 키 이름 지정 후 생성 클릭
6. 생성된 키 복사
7. 검색창에서 원하는 모델 검색 후 이름 복사

호출 파라미터:

• Base URL: https://openrouter.ai/api/v1
• Model Name:
  • GPT-5.2: openai/gpt-5.2
  • Claude Opus 4.5: anthropic/claude-opus-4.5
  • Gemini 3 Pro: google/gemini-3-pro
  • 무료 모델: meta-llama/llama-3.1-8b-instruct:free
• API Key: 생성한 키

충전 방법:

• Alipay (가장 편리)
• 신용카드
• 암호화폐 (USDC 등)

가격 장점:

• 일부 모델은 공식보다 10-20% 저렴
• 투명한 가격, 웹사이트에서 직접 확인 가능
• 다양한 제공업체가 경쟁하므로 가장 저렴한 것을 선택 가능

무료 옵션:

• 일부 모델은 완전 무료 (:free 표시)
• 신규 사용자에게 무료 크레딧 제공
• 무료 모델로 먼저 테스트 가능

모델 순위

• Rankings 페이지에서 플랫폼의 모델 호출 데이터를 확인할 수 있으며, 순위가 매우 신뢰할 만합니다.

기타 무료 플랫폼

지면 관계상 몇 가지 추가로 무료로 사용할 수 있는 플랫폼을 소개합니다.

Cerebras (초고속 추론)

웹사이트: https://cloud.cerebras.ai

특징:

• 매우 빠른 추론 (세계에서 가장 빠르다고 주장)
• 무료 Llama 모델 호출 제공
• 간단한 가입, GitHub 로그인만 있으면 됨

NVIDIA NIM (NVIDIA 공식)

웹사이트: https://build.nvidia.com

특징:

• NVIDIA의 공식 AI 플랫폼
• 여러 무료 모델 제공
• 테스트 및 개발에 적합

두 플랫폼 모두 무료 크레딧을 제공합니다. 관심이 있다면 가입해서 사용해 보세요.

요약

세 가지 핵심 요소:

1. API Key
2. Base URL
3. Model Name

네 가지 추천 플랫폼:

1. DeepSeek 공식 (공식) - 중국에서 가장 저렴한 선택
2. Volcano Engine (공식 + 서드파티) - 국내 플랫폼, 대부분의 국내 오픈소스 모델 호출 가능
3. Google AI Studio (공식) - 해외 최고의 무료 선택 (Cloud 크레딧 포함), 웹에서 직접 사용 가능
4. OpenRouter (서드파티) - 올인원 플랫폼, Alipay 지원