OpenAI, MiniMax, ElevenLabs API 키를 몇 분 만에 만드세요.

1. 어떤 키가 필요한가요?

네 개의 제공자가 Aon Pro Studio의 모든 AI 기능을 담당하며, TTS 음성은 네 가지 제공자 중에서 선택할 수 있습니다. 시작에 필요한 것은 OpenAI뿐이며, MiniMax · ElevenLabs · Typecast는 선택적인 음성/영상 추가 옵션입니다.

지금은 OpenAI 키만으로 시작하고, 더 좋은 음성을 원할 때 MiniMax · ElevenLabs · Typecast를, 모션을 원할 때 MiniMax를 나중에 추가할 수 있습니다. 네 제공자 모두 종량제이거나 무료 플랜이 있습니다. 소액 잔액($5~$10만 넣어도 테스트 가능)을 충전하고 생성한 만큼만 청구됩니다. 예시 가격은 API 비용 가이드를 참고하세요.

2. OpenAI API 키 만들기 (필수)

1단계 - OpenAI 플랫폼 계정 만들기

1. OpenAI 개발자 플랫폼으로 이동하세요: platform.openai.com.
2. Sign up을 클릭하고 이메일, Google 또는 Microsoft 계정으로 가입하세요.
3. 안내가 나오면 이메일과 전화번호를 인증하세요.

참고: ChatGPT Plus 구독은 API와 별개입니다. 이미 ChatGPT를 결제 중이더라도 API는 자체 종량제 과금을 사용합니다.

2단계 - 결제 크레딧 추가

1. 결제 페이지를 여세요: Billing overview.
2. Add payment details를 클릭하고 신용카드를 등록하세요.
3. 선불 크레딧을 구매하세요. 첫 테스트 영상에는 $5~$10이면 충분합니다. 이후 자동 충전을 켤 수도 있지만, 고정된 선불 금액이 지출을 제한하는 가장 안전한 방법입니다.

잔액이 $0인 계정에서 만든 새 키는 "insufficient_quota" 같은 오류를 반환합니다. 먼저 크레딧을 추가하면 가장 흔한 설정 실패를 피할 수 있습니다.

3단계 - API 키 생성

1. API 키 페이지를 여세요: platform.openai.com/api-keys.
2. Create new secret key를 클릭하세요.
3. 알아보기 쉬운 이름(예: aon-pro-studio)을 지정하세요.
4. 권한은 All로 두세요(Aon Pro Studio는 텍스트·이미지·오디오·전사 엔드포인트를 사용합니다).
5. Create secret key를 클릭하고 즉시 키를 복사하세요. 키는 sk-로 시작하며 한 번만 표시됩니다. 분실하면 삭제하고 새로 만드세요.

4단계 - 지출 한도 설정 (선택, 권장)

1. Usage limits를 열어 월 예산 알림과 상한을 설정하세요.
2. Usage 대시보드에서 언제든지 지출을 추적하세요.

3. MiniMax API 키 만들기 (선택, 권장)

고품질 TTS 음성, 이미지-투-비디오(Hailuo 2.3 Fast · H3 · H3 Max), 그리고 광고·스토리 드라마·뮤직비디오·고품질 영상제작 모드의 영상(H3·H3 Max)을 쓰려면 MiniMax를 추가하세요. 지금 건너뛰어도 앱의 나머지 기능은 OpenAI만으로 모두 동작합니다.

1단계 - MiniMax 계정 만들기

1. 글로벌 MiniMax 플랫폼으로 이동하세요: platform.minimax.io.
2. Sign up / Log in을 클릭하고 이메일 또는 Google 계정으로 가입하세요.

중요: 글로벌 사이트 platform.minimax.io를 사용하세요. 중국 지역 플랫폼(minimaxi.com)은 별도의 계정과 키를 사용하며 글로벌 API에서는 작동하지 않습니다.

2단계 - 결제 크레딧 추가

1. 계정 메뉴를 열고 사용자 센터의 Billing / Balance로 이동하세요.
2. 결제 수단을 추가하고 종량제(Pay-as-you-go) 잔액을 충전하세요. TTS와 Hailuo 클립 몇 개를 시험하는 데는 $5~$10이면 충분합니다. H3는 초당 과금이라 광고·드라마·뮤직비디오 한 편에 몇 달러가 들 수 있습니다.
3. 현재 요금은 공식 MiniMax 종량제 가격 페이지에서 확인하세요.

중요: H3·H3 Max 영상은 Token Plan 같은 구독 상품이나 Credits로 만들 수 없습니다(MiniMax 공식 안내). 구독의 Subscription Key는 종량제 API 키와 서로 바꿔 쓸 수 없으므로, 이 앱에는 종량제(Pay-as-you-go) 잔액을 충전한 계정의 API 키를 넣으세요. 구독을 결제했어도 종량제 잔액이 없으면 광고·드라마·뮤직비디오·고품질 모드의 영상 단계에서 402 오류가 납니다.

3단계 - API 키 생성

1. 사용자 센터의 API 키 페이지를 여세요: MiniMax API keys.
2. Create new secret key를 클릭하고 이름(예: aon-pro-studio)을 지정한 뒤 확인하세요.
3. 키를 복사해 안전한 곳에 보관하세요. 비밀번호처럼 다루세요. MiniMax 키는 eyJ로 시작하는 긴 토큰이므로 OpenAI 키보다 훨씬 깁니다.
4. Account / Token Plan 페이지의 Subscription Key가 아니라, 위 API keys 페이지에서 만든 키를 쓰세요.

4. ElevenLabs API 키 만들기 (선택, 권장)

OpenAI, MiniMax와 함께 자연스럽고 표현력 있는 AI 음성을 원할 때 ElevenLabs를 추가하세요. Voice ID를 외울 필요 없이 앱 안에서 목록을 불러와 고르고, 미리듣기는 크레딧 없이 들을 수 있습니다. 지금 건너뛰어도 앱의 나머지 기능은 OpenAI로 동작하며, MiniMax도 음성과 이미지-투-비디오에 계속 사용할 수 있습니다.

1단계 - ElevenLabs 계정 만들기

1. ElevenLabs 웹사이트로 이동하세요: elevenlabs.io.
2. Sign up을 클릭하고 이메일 또는 Google 계정으로 가입하세요.
3. 안내가 나오면 이메일을 인증하세요.

2단계 - 요금제 선택 및 사용량 확인

1. ElevenLabs 가격을 열어 요금제를 확인하세요. 테스트용 무료 등급이 있으며, 유료 요금제는 월 크레딧과 상업적 사용을 추가합니다.
2. ElevenLabs는 문자/크레딧 사용량으로 청구하므로, 예상 내레이션 생성량에 맞는 요금제를 선택하세요.

3단계 - API 키 생성

1. API 키 페이지를 여세요: ElevenLabs API keys (프로필 / 설정 → API Keys).
2. Create API Key를 클릭하고 알아보기 쉬운 이름(예: aon-pro-studio)을 지정한 뒤 확인하세요.
3. 키를 즉시 복사해 안전한 곳에 보관하세요. 비밀번호처럼 다루세요. ElevenLabs 키는 보통 sk_로 시작합니다.

5. Typecast API 키 만들기 (선택)

한국어에 강한 성우 목소리를 원할 때 네 번째 TTS 옵션으로 Typecast를 추가하세요. 앱의 보이스 선택 창에서 Typecast 탭으로 목록을 불러와 무료 샘플을 들은 뒤 고르거나, Voice ID를 직접 넣을 수 있습니다. 모델은 ssfm-v30과 ssfm-v21 중에서 선택하며, 한 번에 2,000자까지 합성합니다.

1단계 - Typecast 계정 만들기

1. Typecast 웹사이트로 이동하세요: typecast.ai.
2. 이메일 또는 Google 계정으로 가입하고, 안내가 나오면 이메일을 인증하세요.

2단계 - API 요금제 확인

1. Typecast API 가격을 열어 요금제를 확인하세요. 무료 플랜은 월 15,000 크레딧을 주고, Lite(월 $15, 200,000 크레딧)부터 유료 플랜이 시작됩니다.
2. 1자당 1크레딧이 소모되므로, 예상 내레이션 분량에 맞는 요금제를 고르세요. 유료 플랜은 한도를 넘으면 종량제로 자동 과금됩니다.

3단계 - API 키 생성

1. API 키 페이지를 여세요: Typecast Developers → API.
2. 새 API 키를 만들고 알아보기 쉬운 이름(예: aon-pro-studio)을 지정하세요.
3. 키를 즉시 복사해 안전한 곳에 보관하세요. 비밀번호처럼 다루세요. 개발 문서는 typecast.ai/docs에 있습니다.

6. Aon Pro Studio에 키 입력

1. Aon Pro Studio를 실행하고 설정을 여세요.
2. OpenAI 키를 OpenAI API 키 입력란에 붙여넣으세요. 이메일이나 메모 앱에서 복사한 키에는 공백이나 줄바꿈이 섞이기 쉬우니 주의하세요.
3. MiniMax 키를 만들었다면 MiniMax API 키 입력란에 붙여넣으세요.
4. ElevenLabs 키를 만들었다면 ElevenLabs API 키 입력란에, Typecast 키를 만들었다면 Typecast API 키 입력란에 붙여넣으세요.
5. 보이스 선택 창을 열어 제공자별 탭에서 목록을 불러오고, 무료 샘플을 들은 뒤 기본 성우를 정하세요. 키를 넣기 전에도 성우는 고를 수 있습니다.
6. 저장한 뒤 짧은 테스트를 실행하세요. 전체 프로젝트를 시작하기 전에 짧은 대본이나 이미지 한 장을 생성해 연결을 확인하세요.

키는 데스크톱 앱에 의해 컴퓨터에 로컬로 저장됩니다. 사용자가 설정한 제공자를 호출하는 데에만 쓰이며, Aon Pro Studio는 사용량을 자체 서버로 중계하거나 크레딧을 재판매하지 않습니다.

유튜브 업로드 연결 (선택)

완성한 영상을 앱에서 바로 유튜브에 올리려면, 처음 한 번 구글 클라우드에서 내 업로드 열쇠(클라이언트 JSON)를 만들어 앱에 넣고 로그인합니다(15분쯤). 영상은 내 컴퓨터에서 내 채널로 바로 올라갑니다. 설정 가이드 영상 보기

1. 구글 클라우드 콘솔에서 새 프로젝트를 만들고 YouTube Data API v3 를 켭니다.
2. Google 인증 플랫폼에서 시작하기 → 대상 '외부' → 앱 게시(프로덕션). 빠뜨리면 로그인이 일주일마다 풀립니다.
3. 데이터 액세스에 youtube.force-ssl 범위를 넣고, 클라이언트에서 데스크톱 앱 클라이언트를 만들어 JSON 을 받습니다.
4. 앱의 통합 설정 › 유튜브 업로드에서 JSON 파일을 넣고 구글 로그인을 합니다. 단계별 바로가기는 앱의 '설정 방법 보기'에 있습니다.

7. 키를 안전하게 보관하세요

• API 키는 비밀번호처럼 다루세요. 키를 가진 사람은 누구나 사용자의 제공자 잔액을 소진할 수 있습니다.
• 가려지지 않은 키가 보이는 스크린샷, 화면 녹화, 라이브 방송을 절대 공유하지 마세요.
• 채팅방, 공개 저장소, 공유 문서에 키를 붙여넣지 마세요.
• 키가 유출되면 제공자의 키 페이지에서 즉시 삭제하고 새로 만드세요. 기존 키는 곧바로 작동을 멈춥니다.
• 무제한 자동 충전보다 선불 잔액과 지출 한도를 우선 사용하면, 실수가 값비싼 사고로 번지지 않습니다.

8. 키 오류 문제 해결

• "Invalid API key" / 인증 오류: 제공자 페이지에서 키를 다시 복사하고 앞뒤 공백을 확인하세요. OpenAI 키는 sk-로, MiniMax 키는 eyJ로 시작하는 긴 토큰입니다. 긴 MiniMax 키는 복사 시 숨은 줄바꿈이 섞일 수 있으니, 오류가 계속되면 먼저 일반 텍스트 필드에 붙여넣어 보세요.
• "Insufficient quota" 또는 과금 오류: 제공자 잔액이 비어 있습니다. OpenAI 결제 페이지 또는 MiniMax 사용자 센터에서 충전하세요.
• MiniMax 402 / "insufficient balance (1008)": 종량제 잔액이 부족합니다. MiniMax 사용자 센터에서 종량제 잔액을 충전하고, API keys 페이지에서 만든 키가 설정에 들어 있는지 확인하세요. H3·H3 Max 영상은 Token Plan 같은 구독이나 Credits로 만들 수 없으므로, 구독을 결제했더라도 종량제 잔액이 필요합니다.
• 요청 한도 오류: 신규 계정은 낮은 요청 한도로 시작하며 사용량이 늘면 증가합니다. 잠시 기다렸다 재시도하거나 더 작은 배치로 실행하세요.
• MiniMax 기능 사용 불가: 키가 중국 지역이 아닌 platform.minimax.io(글로벌)에서 생성되었고 설정에 저장되어 있는지 확인하세요.
• ElevenLabs 음성 사용 불가: ElevenLabs 키가 설정에 저장되어 있고, 요금제에 남은 크레딧이 있으며, 프로젝트의 TTS 제공자로 ElevenLabs가 선택되어 있는지 확인하세요.
• 모델 접근 오류: 일부 모델은 인증된 계정이나 순차 배포가 필요합니다. 제공자 대시보드의 모델 페이지를 확인하세요.

여전히 막히나요? 시작 가이드의 일반 문제 해결 점검을 참고하거나, 공식 이메일 aonprostudio@gmail.com으로 문의하세요.