OpenAI·Anthropic·Google API 키 발급부터 첫 호출까지, 비개발자도 따라하는 실전 가이드

들어가며: 왜 API를 직접 호출해야 할까요?

ChatGPT 웹사이트에서 대화하는 것과 API를 직접 호출하는 것은 완전히 다른 차원의 활용입니다.

💡 API를 이해하면 "AI를 쓰는 사람"에서 **"AI를 업무에 심는 사람"**으로 레벨업할 수 있습니다. 코딩을 몰라도 Postman이라는 무료 도구만으로 충분히 따라할 수 있습니다.

이 가이드를 끝까지 따라하면 OpenAI(GPT-4o), Anthropic(Claude), Google(Gemini) 세 곳의 API를 모두 직접 호출해 볼 수 있습니다. 소요 시간은 약 40~60분입니다.

Step 1. 사전 준비 — Postman 설치하기

Postman은 코딩 없이 API를 테스트할 수 있는 무료 도구입니다. 개발자들이 매일 사용하지만, 비개발자도 쉽게 쓸 수 있습니다.

1-1. Postman 다운로드 및 설치

1. 브라우저에서 postman.com/downloads 에 접속합니다.

2. 화면 중앙의 주황색 "Download the App" 버튼을 클릭합니다.

3. 운영체제(Windows/Mac)에 맞는 설치 파일이 자동으로 다운로드됩니다.

4. 다운로드된 파일을 실행하여 설치를 완료합니다.

5. 설치 후 Postman을 실행하면 회원가입(Sign Up) 화면이 나옵니다.

6. Google 계정 또는 이메일로 무료 계정을 생성합니다.

1-2. 첫 화면 확인

• 로그인 후 상단에 "+" 탭이 보이면 준비 완료입니다.

• 이 "+" 탭을 클릭하면 새로운 API 요청(Request)을 만들 수 있는 화면이 열립니다.

• 왼쪽 드롭다운이 **"GET"**으로 되어 있을 텐데, 이것을 나중에 **"POST"**로 바꿀 예정입니다.

💡 Postman 웹 버전(app.getpostman.com)도 있지만, 데스크톱 앱이 더 안정적입니다. 회사 보안 정책으로 설치가 어려운 경우에만 웹 버전을 사용하세요.

Step 2. OpenAI API 키 발급 및 첫 호출

2-1. API 키 발급

1. 브라우저에서 platform.openai.com 에 접속합니다.

2. ChatGPT 계정과 동일한 계정으로 로그인합니다. (별도 가입이 필요할 수 있습니다.)

3. 로그인 후 왼쪽 사이드바에서 ⚙️ 톱니바퀴 아이콘(Settings) 을 클릭합니다.

4. 왼쪽 메뉴에서 "API keys" 를 클릭합니다.

5. 화면 상단의 "+ Create new secret key" 버튼을 클릭합니다.

6. Name 필드에 "내 첫 번째 키" 라고 입력하고 "Create secret key" 를 클릭합니다.

7. sk-로 시작하는 긴 문자열이 표시됩니다. 이것이 API 키입니다.

8. 반드시 "Copy" 버튼을 눌러 메모장에 붙여넣기 하세요.

⚠️ 이 키는 한 번만 표시됩니다. 창을 닫으면 다시 볼 수 없으므로, 반드시 안전한 곳에 저장하세요. 분실 시 새 키를 발급받아야 합니다.

2-2. 결제 수단 등록 (필수)

API는 유료 서비스이므로 결제 수단을 등록해야 호출이 됩니다.

1. 왼쪽 메뉴에서 "Billing" 을 클릭합니다.

2. "Add payment method" 버튼을 클릭합니다.

3. 신용카드 정보를 입력합니다.

4. "Initial credit balance" 에 $5를 입력합니다. (최소 충전 금액)

OpenAI 요금 구조 핵심:

💡 한글 기준 약 1,500자가 약 1,000토큰입니다. $5만 충전해도 GPT-4o-mini로 수천 번 호출할 수 있으니 부담 없이 시작하세요.

2-3. Postman에서 OpenAI API 호출하기

1. Postman을 열고 상단의 "+" 탭을 클릭하여 새 요청을 만듭니다.

2. 왼쪽 드롭다운을 GET → POST로 변경합니다.

3. URL 입력란에 아래 주소를 그대로 복사·붙여넣기 합니다:

https://api.openai.com/v1/chat/completions

4. URL 입력란 아래의 "Headers" 탭을 클릭합니다.

5. 아래 두 줄을 추가합니다:

주의: Bearer와 sk- 사이에 띄어쓰기 한 칸이 있어야 합니다.

6. "Body" 탭을 클릭합니다.

7. "raw" 라디오 버튼을 선택합니다.

8. 오른쪽 드롭다운을 **"Text" → "JSON"**으로 변경합니다.

9. 아래 내용을 그대로 복사·붙여넣기 합니다:

json

{

"model": "gpt-4o-mini",

"messages": [

{

"role": "system",

"content": "당신은 B2B 영업 전문 어시스턴트입니다. 간결하고 실용적으로 답변하세요."

},

{

"role": "user",

"content": "IT 솔루션 도입을 제안하는 이메일을 작성해줘. 대상은 중견기업 CFO이고, 비용 절감이 핵심 포인트야."

}

],

"temperature": 0.7,

"max_tokens": 1000

}

10. 오른쪽 상단의 파란색 "Send" 버튼을 클릭합니다.

2-4. 응답 확인

하단 영역에 JSON 형태의 응답이 표시됩니다. "choices" 안의 "content" 필드에서 AI가 생성한 이메일 본문을 확인할 수 있습니다. "usage" 필드에서는 사용된 토큰 수를 확인할 수 있습니다.

프롬프트 예시 ① — 콜드 이메일 작성:

"IT 솔루션 도입을 제안하는 이메일을 작성해줘. 대상은 중견기업 CFO이고, 비용 절감이 핵심 포인트야. 300자 이내로 작성하고, CTA(Call to Action)는 15분 미팅 제안으로 해줘."

Step 3. Anthropic (Claude) API 키 발급 및 첫 호출

3-1. API 키 발급

1. 브라우저에서 console.anthropic.com 에 접속합니다.

2. "Sign Up" 을 클릭하여 계정을 생성합니다. (claude.ai 계정과는 별도입니다.)

3. 이메일 인증을 완료합니다.

4. 로그인 후 왼쪽 사이드바에서 "API Keys" 를 클릭합니다.

5. "Create Key" 버튼을 클릭합니다.

6. Name에 "첫 번째 키" 를 입력하고 "Create Key" 를 클릭합니다.

7. sk-ant-로 시작하는 문자열이 표시됩니다. 메모장에 복사해 둡니다.

3-2. 결제 수단 등록

1. 왼쪽 메뉴에서 "Billing" → "Payment Methods" 를 클릭합니다.

2. 신용카드를 등록하고 $5 크레딧을 충전합니다.

Anthropic 요금 구조:

3-3. Postman에서 Claude API 호출하기

1. Postman에서 새 탭("+")을 열고, POST로 설정합니다.

2. URL:

https://api.anthropic.com/v1/messages

3. "Headers" 탭에 아래 세 줄을 추가합니다:

OpenAI와 다르게 x-api-key 라는 헤더를 쓰고, Bearer를 붙이지 않습니다.

4. "Body" → "raw" → "JSON" 선택 후 아래를 붙여넣기:

json

{

"model": "claude-sonnet-4-20250514",

"max_tokens": 1024,

"system": "당신은 10년 경력의 B2B 세일즈 코치입니다.",

"messages": [

{

"role": "user",

"content": "고객사 미팅 후 팔로업 이메일을 써줘. 미팅에서 논의한 내용은 클라우드 마이그레이션이고, 다음 단계는 기술 데모 일정 잡기야."

}

]

}

5. "Send" 버튼을 클릭합니다.

프롬프트 예시 ② — 팔로업 이메일:

"고객사 미팅 후 팔로업 이메일을 써줘. 미팅에서 논의한 내용은 클라우드 마이그레이션이고, 다음 단계는 기술 데모 일정 잡기야. 전문적이면서도 따뜻한 톤으로, 구체적인 날짜 2개를 제안하는 형태로 작성해줘."

3-4. 응답 확인

응답 JSON에서 "content" 배열 안의 "text" 필드에 Claude가 작성한 이메일이 들어 있습니다.

💡 Claude는 긴 문서 분석에 강점이 있습니다. max_tokens을 4096으로 늘리면 더 긴 답변을 받을 수 있습니다.

Step 4. Google Gemini API 키 발급 및 첫 호출

4-1. API 키 발급

Google Gemini API는 세 곳 중 가장 간단하게 키를 발급받을 수 있습니다.

1. 브라우저에서 aistudio.google.com/apikey 에 접속합니다.

2. Google 계정으로 로그인합니다.

3. "API 키 만들기(Create API Key)" 버튼을 클릭합니다.

4. 프로젝트를 선택하라는 화면이 나오면 "새 프로젝트에서 API 키 만들기" 를 선택합니다.

5. AIza로 시작하는 문자열이 생성됩니다. 복사하여 메모장에 저장합니다.

Google Gemini 요금 구조:

💡 Gemini Flash 모델은 무료 티어가 있어서 결제 수단 등록 없이도 테스트할 수 있습니다. 학습 목적이라면 가장 부담 없는 선택입니다.

4-2. Postman에서 Gemini API 호출하기

1. Postman에서 새 탭("+")을 열고, POST로 설정합니다.

2. URL (아래에서 YOUR_API_KEY 부분을 본인 키로 교체):

https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=YOUR_API_KEY

Google은 독특하게 URL 파라미터로 API 키를 전달합니다.

3. "Headers" 탭:

4. "Body" → "raw" → "JSON" 선택 후:

json

{

"contents": [

{

"role": "user",

"parts": [

{

"text": "B2B SaaS 제품의 경쟁사 비교표를 만들어줘. 카테고리는 프로젝트 관리 도구이고, Asana, Monday.com, Jira를 비교해줘. 가격, 주요 기능, 장단점을 포함해줘."

}

]

}

],

"generationConfig": {

"temperature": 0.7,

"maxOutputTokens": 2048

}

}

5. "Send" 를 클릭합니다.

프롬프트 예시 ③ — 경쟁사 분석:

"B2B SaaS 제품의 경쟁사 비교표를 만들어줘. 카테고리는 프로젝트 관리 도구이고, Asana, Monday.com, Jira를 비교해줘. 가격, 주요 기능, 장단점, 그리고 각 도구가 적합한 팀 규모를 마크다운 표로 정리해줘."

4-3. 응답 확인

"candidates" → "content" → "parts" → "text" 경로에서 생성된 답변을 확인할 수 있습니다.

Step 5. 세 API 비교 정리

Step 6. 실전 활용 팁 — 업무에 바로 쓰는 프롬프트 패턴

6-1. temperature 파라미터 조절

• temperature: 0.1~0.3 → 정형화된 보고서, 데이터 요약 (일관된 결과)

• temperature: 0.5~0.7 → 이메일, 일반 업무 문서 (균형 잡힌 결과)

• temperature: 0.8~1.0 → 브레인스토밍, 창의적 카피 (다양한 결과)

💡 B2B 영업 이메일은 temperature 0.5~0.7이 가장 자연스럽습니다. 너무 낮으면 딱딱하고, 너무 높으면 비즈니스 맥락에서 벗어날 수 있습니다.

6-2. 시스템 프롬프트 활용 (Before/After)

Before — 시스템 프롬프트 없이:

"영업 이메일 써줘" → 두루뭉술한 일반 이메일 생성

After — 시스템 프롬프트 설정:

시스템: "당신은 10년 경력의 B2B SaaS 영업 전문가입니다. SPIN 셀링 방법론을 적용하고, 항상 구체적 수치와 ROI를 포함하여 작성합니다."

사용자: "클라우드 보안 솔루션 도입을 제안하는 이메일 써줘"

→ ROI 수치가 포함된, 구조화된 영업 이메일 생성

6-3. 비용 관리 실전 수칙

1. 테스트 단계에서는 항상 mini/flash/haiku 같은 경량 모델을 사용하세요. 프롬프트가 확정된 후에만 상위 모델로 전환합니다.

2. OpenAI 대시보드(platform.openai.com → Usage)에서 일별 사용량을 확인합니다.

3. **월간 사용 한도(Usage Limits)**를 $10으로 설정해두면 예상치 못한 과금을 방지할 수 있습니다.

   • Settings → Limits → "Set a monthly budget" 에서 설정

Step 7. 흔한 에러와 해결법

에러 401: Unauthorized

• 원인: API 키가 잘못 입력됨

• 해결: Bearer 뒤에 공백이 있는지, 키를 복사할 때 앞뒤 공백이 포함되지 않았는지 확인합니다.

에러 429: Rate Limit Exceeded

• 원인: 너무 많은 요청을 짧은 시간에 보냄

• 해결: 30초~1분 기다린 후 다시 시도합니다. 무료 티어는 제한이 더 엄격합니다.

에러 400: Bad Request

• 원인: JSON 형식 오류 (쉼표 누락, 따옴표 오류 등)

• 해결: Body 내용을 jsonlint.com 에 붙여넣어 문법 검증을 합니다.

에러 403: Insufficient Balance

• 원인: 크레딧 잔액 부족

• 해결: Billing 페이지에서 크레딧을 추가 충전합니다.

💡 에러가 발생하면 Postman 하단 응답 영역의 "Body" 탭에서 "error" → "message" 필드를 읽어보세요. 대부분 원인이 영어로 명확하게 적혀 있습니다.

Step 8. 다음 단계 — 코딩 없이 자동화로 확장하기

API 호출에 성공했다면, 이제 실제 업무 자동화로 연결할 수 있습니다.

실제 업무 적용 수치 (Before → After)

• 영업 이메일 작성 시간: 평균 25분 → 3분 (약 88% 단축)

• 고객 미팅 요약 보고서: 수동 작성 40분 → API 호출 후 편집 10분 (약 75% 단축)

• 경쟁사 분석 자료: 반나절 리서치 → 초안 생성 5분 + 팩트체크 30분 (약 70% 단축)

마무리 체크리스트

아래 항목을 모두 완료했는지 확인하세요:

• Postman 설치 및 계정 생성 완료

• OpenAI API 키 발급 및 크레딧 충전 완료

• OpenAI API 호출 성공 (GPT-4o-mini)

• Anthropic API 키 발급 완료

• Claude API 호출 성공

• Google Gemini API 키 발급 완료

• Gemini API 호출 성공

• 세 API의 인증 방식 차이 이해

• temperature 조절 테스트 완료

• 월간 사용 한도 설정 완료

💡 이 가이드에서 사용한 Postman 요청들을 Collection으로 저장해두세요. Postman 왼쪽 사이드바에서 "Save" 버튼을 눌러 "AI API 테스트"라는 폴더를 만들면, 언제든 다시 꺼내 쓸 수 있습니다. 이것이 여러분만의 AI API 실험실이 됩니다.