AI API 30분 시작하기: 키 발급부터 첫 호출까지

웹 화면에서 AI를 쓰는 것과 API로 부르는 것은 다른 세계다. API를 쓰면 내 프로그램, 엑셀 자동화, 챗봇에 AI를 직접 끼워 넣을 수 있다. 어렵게 느껴지지만 실제로는 키 발급 10분, 첫 호출 5분이면 끝난다. 이 글은 OpenAI와 Anthropic 두 곳을 기준으로, curl과 파이썬 예제로 30분 안에 첫 응답을 받는 길을 안내한다. 2026년 5월 기준이다.

한눈에 순서는 (1) 계정 만들고 결제 수단 등록 (2) API 키 발급 (3) 키를 환경변수에 저장 (4) curl로 한 줄 테스트 (5) 파이썬으로 옮기기. 무료 채팅과 달리 API는 사용한 만큼 과금되니 결제 등록이 필수다.

0단계: 준비물

해외 결제가 되는 카드 한 장과 이메일이면 된다. API는 선불 충전 또는 후불 과금 방식이라 결제 수단 없이는 호출이 막힌다. 비용이 걱정되면 먼저 API 가격 비교로 단가를 보고, API 비용 계산기로 한 달 예상치를 잡아두자. 테스트 단계에서는 보통 몇 백 원 수준이다.

1단계: API 키 발급

OpenAI: platform.openai.com 로그인 → 우측 상단 설정 → "API keys" → "Create new secret key". 키는 한 번만 보여주니 즉시 복사해 둔다.
Anthropic: console.anthropic.com 로그인 → "API Keys" → "Create Key". 마찬가지로 생성 직후 한 번만 노출된다.
두 곳 모두 "Billing" 메뉴에서 결제 수단을 등록하고, 월 사용 한도(usage limit)를 낮게 걸어두면 사고를 막을 수 있다.

실전 팁 발급한 키는 코드에 직접 박지 말자. 깃허브에 올라가는 순간 도용된다. 환경변수나 .env 파일에 넣고 .gitignore에 추가하는 습관을 처음부터 들이자.

2단계: 키를 환경변수에 저장

# 맥/리눅스 (터미널)
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."

# 윈도우 (PowerShell)
$env:OPENAI_API_KEY="sk-..."
$env:ANTHROPIC_API_KEY="sk-ant-..."

3단계: curl로 첫 호출

설치 없이 터미널에서 바로 확인할 수 있는 단계다. 응답이 돌아오면 키와 결제가 정상이라는 뜻이다.

# OpenAI (GPT-4o mini)
curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role":"user","content":"한 문장으로 자기소개해줘"}]
  }'

# Anthropic (Claude)
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 200,
    "messages": [{"role":"user","content":"한 문장으로 자기소개해줘"}]
  }'

4단계: 파이썬으로 옮기기

curl이 됐다면 파이썬은 거의 같은 모양이다. 공식 SDK를 깔면 코드가 짧아진다.

pip install openai anthropic

import os
from openai import OpenAI
from anthropic import Anthropic

oai = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
r = oai.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "파이썬으로 인사해줘"}],
)
print(r.choices[0].message.content)

ant = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])
m = ant.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=200,
    messages=[{"role": "user", "content": "파이썬으로 인사해줘"}],
)
print(m.content[0].text)

5단계: 흔한 에러와 해결

증상	원인	해결
401 Unauthorized	키 오타 또는 미설정	환경변수 다시 확인, 키 재발급
429 Too Many Requests	한도 초과 또는 잔액 부족	Billing에서 충전·한도 확인
model not found	모델명 철자 오류	콘솔의 정확한 모델 ID 복사
응답이 잘림	max_tokens 너무 작음	값을 키워서 재요청

API 첫 호출에서 가장 많이 막히는 건 코드가 아니라 결제와 키 설정이다. 401이 뜨면 코드를 의심하기 전에 환경변수부터 다시 출력해 확인하자. 키가 비어 있는 경우가 절반 이상이다.

다음 단계

첫 호출이 됐다면 비용 관리가 다음 과제다. 모델별 단가 차이가 커서 같은 작업도 모델 선택에 따라 10배씩 갈린다. 가장 싼 API와 용도별 AI 선택 가이드를 보고 작업에 맞는 모델을 고르면 된다. API가 처음이라면 개념부터 잡는 AI 입문 가이드도 같이 보길 권한다.

자주 묻는 질문

Q. 무료 크레딧이 있나요?

A. 시기에 따라 신규 가입자에게 소액 크레딧이 제공되기도 하지만, 2026년 기준 보장된 혜택은 아니다. 처음부터 결제 수단 등록을 전제로 보는 게 안전하다.

Q. 키가 노출되면 어떻게 하나요?

A. 콘솔에서 해당 키를 즉시 폐기(revoke)하고 새 키를 발급하면 된다. 노출된 키는 미루지 말고 바로 삭제하는 게 원칙이다.

Q. 웹 챗봇 구독이 있으면 API도 무료인가요?

A. 아니다. ChatGPT Plus나 Claude 구독과 API 과금은 완전히 별개다. API는 사용량만큼 따로 청구된다.