헤븐스튜디오 API 키 설정 가이드 — 처음 한 번만 따라 하면 끝

헤븐스튜디오는 선결제 크레딧 대신, 각자 발급받은 API 키로 쓴 만큼만 과금하는 구조입니다. 그래서 처음 한 번은 키를 발급받아 앱에 등록하는 과정이 필요합니다. 화면에 보이는 글자 그대로, 천천히 따라 하면 됩니다. 헤븐스튜디오가 처음이라면 헤븐스튜디오 완전 정복 글도 함께 참고하세요.

필요한 열쇠 한눈에

앱 오른쪽 위 API 키 버튼을 누르면 아래 칸들이 보입니다. 이 중 Gemini만 필수이고, 나머지는 필요할 때 하나씩 채우면 됩니다.

• Flow 확장앱 — Google Flow 무료 이미지 생성(키 없이 무료), 추천 → Chrome 웹스토어
• Grok 확장앱 — Grok 무료 영상 생성(키 없이 무료), 추천 → Chrome 웹스토어
• Gemini API 키 — 대본·자막 AI, 필수 → aistudio.google.com/apikey
• FAL API 키 — 자막 싱크(Whisper) + PixVerse 영상 변환, 필요 → fal.ai
• Google Cloud TTS 키 — 고음질 한국어 목소리, 필요 → console.cloud.google.com
• YouTube OAuth — 유튜브 자동 업로드, 업로드 쓸 때만 → console.cloud.google.com
• ElevenLabs API 키 — 영어 특화 고급 TTS, 필요 시 → elevenlabs.io

처음이라면 0부(확장앱) → 1부(Gemini) → 2부(FAL) → 3부(Cloud TTS) 순서를 추천합니다. 유튜브 자동 업로드는 나중에 해도 됩니다.

0. 확장앱 설치 — Flow & Grok (키 0개 · 무료 · 약 2분)

헤븐스튜디오의 핵심 기능인 무료 이미지·영상 생성은 크롬 확장앱이 담당합니다. API 키나 별도 요금 없이 본인 구글·Grok 계정으로 생성됩니다.

• 헤븐플로우(Google Flow 이미지 생성) — 설치 링크에서 Chrome에 추가 → 확장 프로그램 추가 확인 → labs.google/fx 접속 시 오른쪽 사이드패널이 열리면 완료입니다.
• 헤븐그록(Grok 영상 생성) — 설치 링크에서 Chrome에 추가 → 확장 프로그램 추가 확인 → grok.com 접속 시 오른쪽 사이드패널이 열리면 완료입니다.

확장앱은 크롬 계열 브라우저에서만 동작합니다. 사이드패널이 안 열리면 주소창 오른쪽 퍼즐 아이콘에서 확장앱을 고정한 뒤 클릭하면 됩니다.

1. Gemini 열쇠 받기 (필수 · 약 5분)

Gemini는 대본과 자막을 만들어주는 AI입니다. 이 열쇠(API 키)가 있어야 앱이 작동합니다. 구글(Gmail) 계정만 있으면 됩니다.

1. 크롬 브라우저에서 평소 쓰는 구글 계정으로 먼저 로그인한 뒤, 주소창에 https://aistudio.google.com/apikey 를 입력합니다.

   화면 오른쪽 위의 파란색 API 키 만들기 버튼을 찾으면 됩니다.

2. 화면 오른쪽 위의 파란색 API 키 만들기(영어 화면이면 Create API key) 버튼을 클릭합니다. 프로젝트를 고르라고 하면 아무거나 선택하거나 새 프로젝트에서 만들기를 누르면 됩니다.

   결제 계정 등록 화면이 나오면: 계정 유형은 반드시 **개인(Individual)**을 선택하세요. “사업자·조직(Business)“으로 선택하면 나중에 키가 막힐 수 있고 되돌리기 어렵습니다.

3. 잠시 후 AIza...로 시작하는 긴 문자열이 나타납니다. 옆의 복사 아이콘을 눌러 복사합니다. 이 열쇠는 비밀번호처럼 다루고, 남에게 보여주거나 화면을 캡처해서 올리지 않아야 합니다.

4. 헤븐스튜디오 화면 오른쪽 위 API 키 버튼을 클릭하고, Gemini API 키 칸에 붙여넣은 뒤 저장 후 새로고침을 누르면 끝입니다.

요금은 처음엔 무료로 쓸 수 있고, 많이 쓰면 구글이 요금을 매깁니다. 화면에 “크레딧 소진”이 뜨면 aistudio.google.com에서 충전하면 됩니다.

2. FAL 키 받기 (자막 싱크 + 영상 변환 · 약 3분)

자막이 음성과 정확히 맞는 기능(Whisper)과 이미지→영상 변환(PixVerse)에 사용됩니다.

1. fal.ai에 접속해 오른쪽 위 Sign Up 버튼을 클릭합니다. Continue with Google이 보이면 그걸로 가입하는 게 가장 빠릅니다.

2. 가입 후 오른쪽 위 프로필 아이콘 → Dashboard → 왼쪽 메뉴 Keys를 클릭합니다.

3. Add key 버튼을 클릭합니다. 이름은 아무거나(예: heaven-studio) 입력하면 긴 열쇠 글자가 나타납니다. 옆의 복사 아이콘으로 바로 복사합니다.

   이 열쇠는 이 화면을 벗어나면 다시 볼 수 없습니다. 놓쳤다면 당황하지 말고 Add key를 다시 눌러 새로 만들면 됩니다.

4. 헤븐스튜디오 API 키 버튼 → FAL API 키 칸에 붙여넣기 → 저장 후 새로고침으로 끝입니다.

요금은 fal.ai 후불 과금입니다. 자막싱크 1회 약 1030원, 영상변환 1회 약 50100원 수준입니다.

3. Google Cloud TTS 키 받기 (고음질 목소리 · 약 5분)

Chirp3 HD 같은 고음질 한국어 목소리를 쓸 때 필요합니다. 1부와 같은 구글 계정, Google Cloud Console에서 발급합니다.

1. console.cloud.google.com에 접속합니다. 1부에서 로그인한 것과 같은 구글 계정이면 됩니다.

2. 화면 맨 위 왼쪽의 프로젝트 이름 부분을 클릭합니다. 이전에 만든 프로젝트가 있으면 선택하고, 없으면 새 프로젝트를 눌러 이름 아무거나 넣고 만듭니다.

3. Text-to-Speech API 활성화 링크로 이동해 파란 사용 버튼을 클릭합니다. “API 사용 설정됨”이 뜨면 성공입니다.

   결제 계정 등록 화면이 나올 수 있습니다. 계정 유형은 반드시 **개인(Individual)**을 선택하세요. 무료 사용량 안에서는 카드를 등록해도 요금이 청구되지 않습니다.

4. 화면 왼쪽 위 ☰ 아이콘 → API 및 서비스 → 사용자 인증 정보 → + 사용자 인증 정보 만들기 → API 키를 클릭합니다.

5. 잠시 후 새 키가 자동으로 만들어져 화면에 나타납니다. 키 값(AIza...) 옆 복사 아이콘을 클릭해 복사합니다.

6. 헤븐스튜디오 API 키 버튼 → Google Cloud TTS API 키 칸에 붙여넣기 → 저장 후 새로고침을 누릅니다.

7. 앱의 음성 설정 메뉴에서 Cloud TTS 탭을 선택하고 원하는 목소리를 고르면 됩니다.

요금은 Google Cloud TTS 무료 구간 월 100만 자, 초과 시 100만 자당 약 23,000원(Chirp HD 기준)입니다.

4. 유튜브 자동 업로드 연결 (자동 업로드 쓸 때만 · 약 15분)

유튜브에 자동으로 올리려면 구글에서 “허가증(OAuth)“을 한 번 만들어야 합니다. 단계가 좀 많지만 천천히 하나씩 따라 하면 됩니다. 준비물은 유튜브 채널이 있는 구글 계정 1개입니다.

단계 1 — 구글 클라우드에서 프로젝트 만들기

console.cloud.google.com에서 화면 맨 위 왼쪽의 **프로젝트 선택 ▾**을 누릅니다.

3부(Cloud TTS)를 이미 했다면 그때 만든 프로젝트를 목록에서 그대로 선택하고, 아래 “새 프로젝트” 만들기는 건너뛰어도 됩니다.

새로 만드는 경우: 오른쪽 위 새 프로젝트 → 이름 아무거나(예: heaven-youtube) → 만들기. 이 단계에서 결제(카드) 등록 화면이 나오면, 계정 유형은 반드시 **개인(Individual)**으로 선택하세요.

단계 2 — YouTube Data API v3 켜기

YouTube Data API v3 페이지를 열고 파란색 사용을 클릭합니다. “API 사용 설정됨”이 나오면 완료입니다.

단계 3 — 동의 화면 만들기

왼쪽 ☰ → API 및 서비스 → OAuth 동의 화면으로 들어갑니다. User Type은 외부(External) → 만들기를 선택합니다. 앱 이름(아무거나), 사용자 지원 이메일, 개발자 연락처 이메일만 채우고 나머지는 저장 후 계속 누르면 됩니다.

대시보드로 돌아와서 앱 게시를 꼭 눌러야 합니다. 안 누르면 7일마다 유튜브 연결이 끊깁니다. 게시하면 무료로 영구 유지됩니다.

단계 4 — 클라이언트 ID 만들기

왼쪽 메뉴 → API 및 서비스 → 사용자 인증 정보 → + 사용자 인증 정보 만들기 → OAuth 클라이언트 ID. 애플리케이션 유형은 반드시 웹 애플리케이션을 선택합니다. “승인된 리디렉션 URI”에 + URI 추가를 누르고 아래 주소를 정확히 붙여넣습니다.

https://heaven-studio.vercel.app/

제일 많이 틀리는 곳입니다. 맨 끝 슬래시(/)까지 오타 없이 넣어야 합니다. 틀리면 redirect_uri_mismatch 오류가 납니다.

만들기를 누르면 클라이언트 ID와 클라이언트 보안 비밀번호(GOCSPX-...) 두 개가 나옵니다. 둘 다 복사해둡니다.

단계 5 — 앱에 입력하고 채널 연결하기

헤븐스튜디오 API 키 → YouTube 두 칸에 각각 붙여넣고 저장 후 새로고침. AutoTube → 채널 관리 → + 채널 추가 → 유튜브 채널이 있는 구글 계정으로 로그인합니다.

“확인되지 않은 앱” 경고는 정상입니다. 본인이 만든 앱이라 뜨는 경고입니다. 고급 → (앱이름)(으)로 이동(안전하지 않음) → 허용을 누르면 됩니다.

채널 옆에 초록불(연결됨)이 뜨면 완료입니다. 이제 AutoTube에서 자동으로 유튜브에 올라갑니다.

5. ElevenLabs — 영어 특화 TTS (필요 시)

영어 콘텐츠나 특정 음색이 필요할 때 사용합니다. 한국어는 Google Cloud TTS로 충분합니다. 필요하면 elevenlabs.io → API Keys → 키 복사 → 앱 ElevenLabs 칸에 입력하면 됩니다.

막히면 여기부터 보세요

“확인되지 않은 앱” 경고가 떠요 — 정상입니다. 고급 → (앱이름)(으)로 이동을 누르면 됩니다. 본인이 만든 앱이라 뜨는 거예요.

redirect_uri_mismatch 오류가 나요 — 단계 4에서 넣은 주소 https://heaven-studio.vercel.app/를 끝 슬래시까지 정확히 넣었는지 확인하세요.

며칠 뒤 유튜브 연결이 끊겨요(invalid_grant) — 단계 3 “앱 게시”를 안 했을 때 그렇습니다. 게시 후 채널을 다시 연결하면 됩니다.

“크레딧 소진”이 떠요 — Gemini를 많이 써서 그렇습니다. AI Studio에서 충전하면 됩니다. 유튜브·OAuth는 무료입니다.

확장앱 사이드패널이 안 열려요 — 크롬 주소창 오른쪽 퍼즐 아이콘에서 해당 확장앱을 핀 고정한 뒤 클릭하면 열립니다.

너무 어려워요 — 1부(Gemini)와 2부(FAL)만 해도 대본·자막·영상을 다 만들 수 있습니다. 나머지는 나중에 천천히 하셔도 됩니다.

한 번만 해두면 계속 씁니다. 천천히, 하나씩 하면 됩니다.