본문으로 건너뛰기

제미나이·OpenAI·Claude API 키 발급 — 받는 곳과 안 될 때

업데이트

읽는 분
AI API 를 처음 붙이는 개발자
끝나면
쓸 회사의 키를 받아 환경변수에 넣고, 막히면 원인을 좁혀요.

키는 회사마다 따로 받아요

Google(Gemini)·OpenAI·Anthropic(Claude)은 각자 콘솔에서 API 키를 줘요. 원포트 AI 는 이 회사들의 키를 대신 발급하지 않아요.

아래는 세 회사의 공식 문서를 2026년 10월 7일에 확인해 옮겼어요. 버튼 이름은 바뀔 수 있어요.

API 키를 받는 곳 — 세 회사 공식 문서, 2026년 10월 7일 확인
Google Gemini받는 곳Google AI Studio 의 API 키 화면다시 보기AI Studio 에서 다시 봐요환경변수GEMINI_API_KEY
OpenAI받는 곳OpenAI 플랫폼의 API 키 페이지다시 보기만들 때 한 번만환경변수OPENAI_API_KEY
Anthropic Claude받는 곳Claude Console 설정 > API keys다시 보기만들 때 한 번만환경변수ANTHROPIC_API_KEY

세 회사 SDK 는 이 환경변수를 알아서 읽어요. Gemini 는 GOOGLE_API_KEY 도 읽고, 둘 다 있으면 GOOGLE_API_KEY 를 먼저 써요.

Gemini API 키

  1. Google AI Studio 에 로그인해 약관에 동의해요. 처음 쓰는 분은 기본 Google Cloud 프로젝트와 API 키가 저절로 생겨요.
  2. 이미 Google Cloud 를 쓰는 분은 기본 프로젝트가 생기지 않아요. 대시보드의 Projects 에서 「Import projects」로 쓸 프로젝트를 가져온 뒤 API Keys 화면에서 키를 만들어요.
  • 「Create API key」가 눌리지 않아요

    확인
    「You do not have permission to create a key in this project」가 보이면, 그 Google Cloud 프로젝트에서 키를 만들 권한이 없어요.
    이렇게 해요
    프로젝트·조직 관리자에게 프로젝트 편집자 같은 역할을 받아요. 어렵다면 조직에 묶이지 않은 새 프로젝트를 만들어 키를 받아요.
  • 예전에 만든 키가 거절돼요

    확인
    Gemini API 는 제한이 걸리지 않은 표준 키의 요청을 거절해요. 2026년 5월 28일부터 AI Studio 에서 새로 만드는 키는 인증 키예요.
    이렇게 해요
    AI Studio 에서 새 키를 만들어 바꿔요. 쓰던 표준 키에 API 제한을 걸어도 그대로 써요.
  • 키가 밖으로 새 나간 것 같아요

    확인
    다른 사람이 그 프로젝트의 할당량과 요금을 쓸 수 있어요.
    이렇게 해요
    새 키를 만들어 앱에 먼저 넣고, 잘 돌면 옛 키를 꺼요. Google Cloud 의 결제·사용 기록에서 모르는 사용이 있었는지 봐요.

OpenAI API 키

  1. OpenAI 플랫폼에 로그인해 API 키 페이지에서 새 키를 만들어요.
  2. 키가 보일 때 바로 안전한 곳에 적어 둬요. 잃어버리면 새 키를 만들어 바꿔요.
  • 모델이나 기능을 쓰려니 인증을 하래요

    확인
    OpenAI 는 일부 제품·모델 전에 조직 인증(법적 이름·주소·사업자 정보)이나 신원 인증(정부 발급 신분증)을 요청해요. 신원 인증은 한 사람이 계정이나 조직 하나만 할 수 있어요.
    이렇게 해요
    인증을 요청한 화면의 안내에서 시작하고, 이름·주소를 공식 기록과 똑같이 적어요. 결과는 손으로 바꿀 수 없고, 승인이 안 돼도 이미 쓰던 서비스는 그대로 써요.
  • 키를 지웠더니 앱이 멈췄어요

    확인
    지운 키는 다시 쓸 수 없어요.
    이렇게 해요
    새 키를 만들어 그 키를 쓰던 앱에 넣어요.
  • 키는 맞는데 결제·한도 오류가 나요

    확인
    키 문제가 아니라 크레딧 잔액이나 사용 등급 한도 문제예요.
    이렇게 해요
    결제 오류·영수증·한도 글을 봐요.

Claude API 키

  1. Claude Console 에 로그인해 설정 > API keys 로 가요.
  2. 「Create key」를 눌러 이름과 만료를 정하고, 연결 계정을 나나 서비스 계정으로 골라요. 혼자 개발할 땐 개인 키, 여럿이 쓰는 서비스엔 서비스 계정 키를 써요.
  3. 키(sk-ant- 로 시작)가 보일 때 바로 안전한 곳에 적어 둬요.
  • 「Create key」가 꺼져 있어요

    확인
    지금 역할로는 그 자리에서 키를 만들 수 없어요.
    이렇게 해요
    조직 관리자에게 역할을 바꿔 달라고 하거나, 서비스 계정 키를 만들어 달라고 해요.
  • 퇴사한 분이 만든 키가 멈췄어요

    확인
    개인 키는 만든 사람이 조직을 떠나면 멈춰요.
    이렇게 해요
    여럿이 쓰는 서비스는 서비스 계정 키로 바꿔요.
  • 키는 있는데 크레딧 결제가 막혀요

    확인
    키와 결제는 따로예요. 콘솔에서 크레딧을 사야 키가 돌아요.
    이렇게 해요
    Claude API 결제가 안 될 때 글을 봐요.

키 하나로 셋 다 부르려면

원포트 AI 지갑에서 만든 키 하나로 Gemini·GPT·Claude 모델을 불러요. 쓰던 OpenAI·Anthropic SDK 의 base_url 과 키만 바꾸고, 회사마다 카드와 결제 계정을 따로 열지 않아요.

모델을 정하지 않은 「원포트 AI API 크레딧」으로 사면 셋 다 불러요. 클로드·GPT 팩처럼 회사를 정한 팩으로 산 크레딧은 Gemini 를 부르지 못해요.

크레딧은 원화(부가세 포함)로 사고, 사람마다 키를 만들어 키마다 한 달 한도를 걸어요.

자주 묻는 질문

API 키는 무료인가요?

키를 만드는 데는 돈이 들지 않아요. 키로 모델을 부른 만큼 요금이 붙어요. OpenAI·Claude 는 미리 산 크레딧에서 빠지고, Gemini 는 무료 등급과 유료 등급이 있어요.

키 하나를 팀이 같이 써도 되나요?

OpenAI 는 키를 누구와도 공유하지 말라고 안내해요. Claude 의 개인 키는 만든 사람으로 움직여요. 사람마다 키를 따로 만들면 누가 얼마 썼는지 갈리고, 한 사람이 나가도 그 키만 끄면 돼요.

함께 보면 좋은 글

도움말 전체 보기