Gemini API 키 발급은 좌절의 연속

 (ankursethi.com)
3P by GN⁺ | ★ favorite | 댓글 1개
  • Google Gemini 3 Pro API 키 발급 과정이 지나치게 복잡해 개인 개발자가 접근하기 어려운 구조로 되어 있음
  • Gemini라는 이름이 여러 제품군에 중복 적용되어 있어, 어떤 서비스가 어떤 기능을 제공하는지 명확히 구분하기 어려움
  • Google AI Studio에서 API 키 생성은 간단하지만, 결제 설정 과정이 Google Cloud Console로 전환되며 복잡한 인증 절차와 서류 제출을 요구함
  • 결제 계정 인증 후에도 403 Forbidden 오류가 반복되어, 실제 사용 가능 상태에 도달하기까지 수 시간 소요됨
  • 전체 경험은 대기업 중심의 비효율적 절차를 보여주며, OpenAI나 Anthropic의 간결한 접근 방식과 대조됨

Gemini 제품군의 혼란

  • “Gemini”라는 이름은 챗봇, 모바일 앱, 음성 비서, Workspace 내 AI 기능, CLI 도구, IDE 확장, LLM 모델 등 다양한 제품에 사용됨
    • 예: gemini.google.com의 챗봇, Android/iPhone 앱, Gemini CLI, Gemini Code Assist, Vertex AI Platform 등
  • 동일한 이름이 여러 서비스에 걸쳐 사용되어, 개발자용 API 접근 경로를 찾기 어려운 상황 발생
  • Anthropic과 OpenAI는 각각 소비자용 웹 서비스와 개발자 콘솔 두 가지 접근 경로만 제공해 훨씬 단순한 구조를 유지

API 키 생성 과정

  • Google AI Studio에서 API 키 생성은 간단하며, 몇 초 만에 새 키를 발급받을 수 있음
  • 발급된 키는 Gemini CLI에서 정상적으로 인식되었으나, 유료 API 크레딧 결제 설정이 필요함
  • “Set up billing” 링크를 클릭하면 Google Cloud Console로 이동, 이후 복잡한 절차가 시작됨

결제 계정 설정의 복잡성

  • 단순 결제가 불가능하며, Billing Account 생성 → 프로젝트 연결 → 결제 수단 추가 → 결제 수단 인증 단계를 거쳐야 함
  • 인도 지역 신용카드의 2단계 OTP 인증 후에도 추가로 정부 발급 신분증과 카드 사진 제출을 요구
    • 카드 번호는 직접 이미지 편집기로 가려야 하며, 업로드는 PNG 형식만 허용
  • 업로드 오류가 반복되었고, 검증 완료까지 며칠 소요된다는 안내 메일을 받음

403 오류와 계정 복구

  • 검증 완료 후에도 Gemini CLI와 API 호출 시 403 Forbidden 오류가 지속 발생
    • Google 문서의 JavaScript 예제 코드로 테스트했으나 동일한 오류 발생
    • AI Studio Playground에서도 “Failed to generate content” 메시지 출력
  • 이후 Google로부터 “Your account is in good standing”이라는 메일을 받은 뒤에야 정상 작동
    • 이후 Playground, API, CLI 모두에서 Gemini 3 Pro 사용 가능 상태로 전환

절차에 대한 평가

  • 전체 과정은 3시간 이상 소요된 비효율적 경험으로, 개인 개발자에게는 불필요하게 복잡한 구조
  • Google의 시스템은 대규모 조직의 규제 준수 중심으로 설계되어, 개인 사용자의 생산성을 저해
  • 반면 OpenAI와 Anthropic은 간단한 결제 및 API 접근 절차를 제공해 개발자 친화적임
  • Gemini 3 Pro의 성능을 평가하기 위해 한 달간 시험적으로 사용할 예정이나, 고객 중심성이 부족한 플랫폼으로 인식됨

함께 보면 좋은 글 β

GN⁺   [-]
Hacker News 의견들

  • Microsoft Azure에서는 훨씬 더 끔찍한 경험을 했음
    진행 중에 ‘공식 인증된 Microsoft 지원’이라 주장하는 제3자 영업팀이 접근해 와서, 실제로는 과도한 요금 옵션을 팔려는 시도였음을 깨달았음

  • 아이와 함께 게임을 만들며 텍스트 음성 변환(TTS) 기능을 실험했음
    브라우저에서 Google Gemini 모델을 테스트했는데 잘 작동했음. 하지만 API로 통합하려다 여러 시행착오를 겪었음

    1. Gemini API는 프로토타이핑용이라 오류율이 30% 정도였고, Vertex API는 안정적이지만 기능이 부족했음. TTS API는 같은 모델임에도 성능이 매우 나빴음
    2. 각 API가 지원하는 파라미터가 달라 원하는 조합을 만들 수 없었음
    3. 문서를 직접 읽거나, Claude Code로 문서를 요약시켜 실험해야 했음. 다만 환각 정보가 섞일 위험이 있었음
    • API로 호출할 때와 Gemini UI에서 사용할 때 모델 성능이 다르게 나옴
      Gemini API는 약 1% 확률로 무작위 실패가 발생하므로 재시도 로직이 필수임
      또한 API 응답 속도는 Google의 내부 상태에 따라 30초에서 4분까지 들쭉날쭉함

  • Google AdWords 초창기에는 신용카드만 있으면 누구나 광고를 게재할 수 있었음
    이 즉시 접근성 덕분에 신뢰를 얻었고, 일반 사용자도 대기업과 동등하게 대우받는 느낌을 받았음
    하지만 2008년 DoubleClick 인수 이후, Google의 고객이 사용자에서 기업 중심으로 바뀌며 방향이 달라졌다고 생각함

    • 나는 항상 제품과 영업팀에게 즉시 가입(Self-signup) 의 중요성을 강조해왔음
      굳이 사람과 대화하거나 기다리지 않고 바로 결제하고 쓰고 싶음
      하지만 영업팀은 가격 차별화나 설득 기회를 원하기 때문에 이런 구조를 유지함
    • 지금의 Google AdWords는 가장 친절하지 않은 온보딩 경험을 주는 서비스 중 하나임
      가입은 쉽지만 첫 광고를 설정하자마자 계정이 정지되고, 항소도 소용없음
      전문가를 고용해야만 제대로 사용할 수 있는 수준임

  • AWS나 GCP의 Cloud Console UI가 어떻게 이런 상태로 출시될 수 있는지 늘 궁금했음
    이런 제품을 내놓고도 만족하거나 승진할 수 있다는 게 이해되지 않음

    • Google 리더십이 실제로 GCP 인터페이스를 데모 외에 직접 써본 적이 있을까 의문임
    • Google에는 리더십이 아니라 주주만 존재한다고 느껴짐
    • AWS 콘솔의 복잡한 구조는 Conway의 법칙의 완벽한 사례임
      관련 내용은 Conway’s Law 위키와 Molly Rocket의 영상 “The Only Unbreakable Rule” 참고

  • gemini API key를 검색하면 바로 공식 문서가 나옴
    문서 첫 부분에 링크도 있고, 마케팅식 디자인이 아니라 깔끔해서 좋다고 생각함
    아마 문제는 결제 관련일 수도 있음

    • 키 생성은 쉽지만 결제와 청구 과정이 문제임
    • 여러 번 시도했지만 Gemini API 결제가 여전히 안 됨. Logan에게 문의해도 별다른 해결이 없었음
    • 대부분의 불만은 gemini-cli의 형편없는 경험을 전체 Gemini 접근성과 혼동한 것 같음
    • 실제 프로덕션 환경은 AI Studio가 아니라 Vertex AI임
      예전에는 서비스 계정 설정이 복잡했고, 문서도 CLI 인증 위주였음
      최근에는 Express Mode로 API Key 사용이 가능해졌지만, 불만이 생길 만했음
      과거에는 Vertex와 AI Studio 간 기능 차이도 심했음
      관련 토론: Google AI Studio 포럼
    • 모든 부분이 하루에도 여러 번 부분적으로 고장남
      개인 Workspace 계정으로 AI Studio를 쓰는데, 어느 날부터 Gemini CLI가 API 키를 거부함
      이유도 설명도 없음. 결제도 하고 있는데 접근이 막힘
      회사 계정으로 전환하려 했지만, 문서가 비슷비슷해서 잘못된 서비스에 가입함
      결국 Gemini Pro에게 물어보니 27단계 절차를 알려줌. 그중 하나라도 막히면 다시 처음부터임
      Azure도 비슷하거나 더 나쁨. GPT-5 접근 권한조차 없음

  • “Set up billing” 링크를 눌렀더니 Google AI Studio에서 Cloud Console로 이동했음
    그 순간 절망감이 밀려왔음. AWS나 GCP 콘솔에 들어갈 때마다 낡은 문서와 복잡한 대시보드에 시간을 낭비함

    • “그 낡은 AWS 문서가 지금 이 방에도 있는 건가요?”라는 농담이 나올 정도임

  • Gemini를 쓰다 똑같은 이유로 포기했음
    Google의 복잡한 절차에 시간을 낭비할 여유가 없음

  • “nano banana pro”를 보고 API 키를 받으려다 5분 만에 포기했음
    나만 그런 줄 알았는데 똑똑한 사람들도 다들 막힘
    맥도날드 키오스크는 글을 몰라도 햄버거를 주문할 수 있는데, 왜 Google은 이런 기본 UX를 못 만드는지 의문임

    • IBM의 AI 클라우드도 비슷했음. 문서가 낡았고, 여러 종류의 API 키 중 진짜는 하나뿐이었음
      마치 마리오 성 레벨처럼 정확한 순서를 따라야만 빠져나올 수 있었음
      IBM이라면 이해되지만, Google이 그 단계에 도달한 듯함
    • Google 내부 문화가 사용자 비우호적 버블에 갇혀 있어서 이런 결과가 나온다고 생각함

  • Gemini API 팀이 본다면, Structured Outputs 사용 시 발생하는
    'The specified schema produces a constraint that has too many states for serving' 오류에 대해
    좀 더 투명한 설명을 부탁하고 싶음
    아마 제약 문법이나 토큰 마스크가 너무 커지는 문제일 듯함
    OpenAI는 명확한 문서와 관대한 제한을 제공함
    관련 이슈도 GitHub에서 이유 없이 닫힘
    그래도 Gemini 모델의 속도는 인상적이며, 작년보다 API 품질이 많이 나아졌음

  • 예전에 HN에서 불만을 올렸더니 Logan이 직접 피드백을 요청했음
    그는 X 계정에서도 활발히 활동하며, 다음 달 AI Studio의 UX/UI 개선을 예고했음
    거대한 조직 속에서도 제품에 집중하는 모습이 보여 기대감이 큼

    • 하지만 Bluesky에서 “vibe coding 업데이트”를 예고한 건 시기상조로 보임
      팀의 방향성이 불분명하고, Google PM들이 예전만큼 현장 감각이 없다고 느낌
    • Google 개발자 관계팀이 피드백을 자주 받지만, 실제 행동으로 이어지는 경우는 드묾
      전략적으로 중요해질 때까지 기다리는 듯함
      왜 “결제 과정을 쉽게 만드는 것”이 전략적으로 중요하지 않은지 이해가 안 됨
답변달기