Claude를 호출하는 API 키, 세 단계로 발급
이메일로 가입하고, 카드나 암호화폐로 $10부터 충전하고, 콘솔에서 키를 만들면 끝입니다. 이 키는 Claude뿐 아니라 카탈로그의 모든 모델을 호출하며, 요금은 토큰당 선불로 차감됩니다.
01어떤 키를 받게 되나
"Claude API 키"라고 부르는 것에는 두 종류가 있습니다. 하나는 Anthropic 콘솔에서 만들고 Anthropic에 선불로 결제하는 공식 키이고, 다른 하나는 게이트웨이에 결제하고 게이트웨이가 요청을 모델로 전달하는 키입니다. 이 페이지에서 발급하는 것은 후자입니다.
키는 sk-relay-로 시작하고 Base URL은 https://api.relayswitch.io/v1입니다. 요청 형식은 바뀌지 않습니다. Anthropic Messages와 OpenAI Chat Completions 두 형식을 모두 받고, model에는 Claude 모델 id를 그대로 씁니다. 공식 키와 달라지는 점은 세 가지입니다: 결제 수단이 카드 또는 암호화폐이고, 가격은 이 카탈로그의 단가를 따르며, 요청마다 오프라인으로 검증할 수 있는 서명된 영수증이 붙습니다.
02발급 절차
세 단계는 순서대로 진행합니다. 처음에는 최소 금액으로 흐름을 끝까지 확인한 뒤 금액을 늘리기를 권합니다. 환불 규칙과 결제 수단별 세부 사항은 결제 페이지에 있습니다.
- 가입: app.relayswitch.io 에서 이메일을 입력하고 받은 인증 코드로 로그인합니다. Google 또는 GitHub 계정으로도 로그인할 수 있습니다. 휴대폰 번호나 신분증은 요구하지 않습니다.
- 충전: 카드(Apple Pay, Google Pay) 또는 암호화폐를 고르고 $10 이상을 충전합니다. 반영된 잔액은 달러로 표시됩니다.
- 키 생성: 이름을 정하고 필요하면 예산과 허용 목록을 설정한 뒤 생성합니다. 전체 키는 이때 한 번만 표시되고 이후 콘솔에는 앞부분만 보이므로 바로 비밀번호 관리자에 저장하십시오.
03키 하나에 걸 수 있는 제한
키는 켜짐과 꺼짐 두 상태만 있는 것이 아닙니다. 키마다 따로 제한을 걸 수 있어 도구별, 팀원별, 서비스별로 나눠 쓰기에 좋습니다.
아무 제한도 걸지 않은 키는 카탈로그의 모든 모델을 호출하고 계정 전체 잔액을 씁니다. 기본 속도 제한은 키당 분당 600회 요청이며, 새 계정은 처음 24시간 동안 키당 분당 60회로 계산됩니다.
| 달러 예산 | 계정 잔액에서 이 키 몫으로 떼어 둔 금액입니다. 다 쓰면 402 key_budget_exhausted를 반환하고 계정의 나머지 잔액은 그대로입니다. |
| 일, 주, 월 사용 한도 | UTC 기준 하루, 월요일에 시작하는 한 주, 달력상의 한 달 단위로 계산합니다. 한도에 닿으면 402를 반환하고 다음 주기에 자동으로 풀립니다. |
| 모델 허용 목록 | 목록에 넣은 모델 id만 호출할 수 있습니다. 목록 밖의 id는 403 scope_denied를 반환합니다. |
| IP 허용 목록 | 지정한 주소나 대역에서 온 요청만 받습니다. 그 밖의 주소는 403 ip_not_allowed를 반환합니다. |
| 속도 제한 | 분당 요청 수, 분당 토큰 수, 동시 요청 수입니다. 넘으면 429를 반환하고 retry-after 헤더가 기다릴 초 수를 알려 줍니다. |
| 만료일 | 선택 사항이며 설정하지 않으면 만료되지 않습니다. 만료되거나 폐기된 키는 401을 반환합니다. |
04Claude 모델 현재 가격
지금 카탈로그에 있는 Claude 모델 13개의 가격입니다. 손으로 적은 숫자가 아니라 페이지를 렌더링할 때 읽어 온 값입니다. 다른 개발사 모델까지 포함한 전체 표는 모델 목록에 있습니다.
| 모델 | 개발사 | 입력 | 출력 | 컨텍스트 |
|---|---|---|---|---|
| Claude Fable 5.1claude-fable-5.1 | Anthropic | $6.00 | $30.00 | 1,000,000 |
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Fable 5claude-fable-5 | Anthropic | $3.00 | $15.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6 | Anthropic | $1.80 | $9.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 5claude-opus-5 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5 | Anthropic | $0.60 | $3.00 | 200,000 |
| Claude Sonnet 5claude-sonnet-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5 | Anthropic | $0.0582 | $0.1455 | 1,000,000 |
백만 토큰당 가격(USD)
05발급한 키 테스트하기
먼저 이 키로 호출할 수 있는 모델 id 목록을 조회합니다. 이 요청은 과금되지 않으며, 200이 돌아오면 키와 주소가 맞는 것입니다.
다음으로 Claude API 사용법 페이지의 curl 예제로 최소 크기의 Messages 요청을 하나 보내 보십시오. 응답 헤더의 요청 id로 서명된 영수증을 조회하면 모델, 과금 토큰, 비용을 확인할 수 있습니다. 401, 402, 403이 돌아오면 같은 페이지의 오류 코드 표를 참고하십시오.
curl https://api.relayswitch.io/v1/models \ -H "Authorization: Bearer sk-relay-..."06키를 어디에 쓰나
- Claude Code: 환경 변수 두 개로 연결합니다. Claude Code 설정 페이지를 보십시오.
- 에디터 확장과 클라이언트: Base URL을 설정할 수 있는 도구라면 어디든 넣을 수 있습니다. Cursor, Cline 등 도구별 입력 위치는 영어 가이드에 있습니다.
- 직접 작성한 코드: Anthropic SDK 또는 OpenAI SDK에서 Base URL과 키만 바꿉니다.
자주 묻는 질문
- 이 키는 Anthropic 공식 API 키인가요?
- 아닙니다. Anthropic 공식 키는 Anthropic 콘솔에서 만듭니다. 여기서 발급하는 키는 RelaySwitch 게이트웨이의 키로 sk-relay- 로 시작하고 Base URL은 https://api.relayswitch.io/v1 입니다. 호출할 때 쓰는 모델 id는 Claude의 id 그대로이며 Anthropic SDK와 OpenAI SDK에서 바로 쓸 수 있습니다.
- 최소 충전 금액은 얼마인가요?
- $10입니다. 충전 단위는 $10, $25, $50, $100, $250, $500이며 잔액은 달러로 표시되고 토큰 단위로 차감됩니다. 구독은 필요 없습니다.
- 키나 잔액에 유효 기간이 있나요?
- 키는 생성할 때 만료일을 지정하거나 직접 폐기하지 않는 한 만료되지 않습니다. 잔액도 만료되지 않습니다.
- 이 키로 Claude만 호출할 수 있나요?
- 아닙니다. 같은 키로 카탈로그의 모든 모델을 호출합니다. Claude만 쓰게 하려면 키에 모델 허용 목록을 설정하십시오.
- 키가 유출되면 어떻게 하나요?
- 콘솔에서 그 키를 폐기하면 즉시 무효가 됩니다. 그런 다음 새 키를 만드십시오. 평소에 도구와 기기마다 키를 따로 만들고 예산을 걸어 두면 유출되어도 손실이 그 키의 예산을 넘지 않습니다.
- 인보이스를 받을 수 있나요?
- 콘솔의 Account 페이지에 회사명, 주소, 세금 식별 번호를 저장해 두면 충전할 때마다 번호가 매겨진 영문 PDF 인보이스가 발급됩니다. 부가가치세나 판매세는 청구되지 않습니다.