AI API 키 발급 가이드 — Gemini·OpenAI·Claude·DeepSeek·OpenRouter

moru 데스크톱 앱은 사용자 본인의 API 키로 AI 제공사에 직접 요청하는 구조입니다. 중간 마진이 없어 가장 싸게 쓰는 방법이지만, 처음이라면 "키 발급"부터 막히기 쉽습니다. 제공사별로 순서대로 정리했습니다.

시작 전에 — 세 가지 원칙

1. API 키는 비밀번호입니다. 스크린샷·디스코드에 절대 올리지 마세요. 노출됐다면 즉시 폐기(revoke)하고 재발급하면 됩니다.
2. 사용 한도를 먼저 걸어 두세요. 모든 제공사 콘솔에 월 예산·한도 설정이 있습니다. 대형 모드팩은 토큰 수천만 개를 쓰기 때문에, 가성비 모델이면 몇천 원으로 끝나지만 프리미엄 모델을 잘못 물리면 수십만 원까지 나올 수 있습니다. 한도는 공짜 안전장치입니다.
3. moru에 입력한 키는 OS 키체인에만 저장됩니다(서버 전송 없음). 그래도 공용 PC에서는 사용 후 설정에서 키를 지우는 습관을 권합니다.

Google Gemini — 가장 쉽게 시작

가성비 라인업(Flash / Flash-Lite)이 강력해서 moru 사용자에게 가장 먼저 권하는 제공사입니다.

1. Google AI Studio에 구글 계정으로 로그인
2. 좌측 상단 Get API key → API 키 만들기
3. 생성된 AIza... 키를 복사해 moru의 Gemini 제공사 설정에 붙여넣기

무료 티어(분당·일일 요청 제한 있음)로도 소형 팩은 시험해 볼 수 있고, 결제를 연결하면 제한이 크게 풀립니다. 결제는 Google Cloud 콘솔에서 연결합니다.

OpenAI — GPT 계열

1. platform.openai.com 가입 (ChatGPT 계정과 별도 결제라는 점 주의 — ChatGPT Plus 구독과 API 크레딧은 다릅니다)
2. Settings → Billing에서 결제 수단 등록 후 크레딧 충전 (최소 $5)
3. API keys → Create new secret key → sk-... 키 복사
4. Limits에서 월 사용 한도 설정

Anthropic Claude — 최고 품질 라인

1. console.anthropic.com 가입
2. Billing에서 크레딧 충전 (최소 $5)
3. API Keys → Create Key → sk-ant-... 복사
4. Workspace 단위로 지출 한도를 걸 수 있습니다

Sonnet 5(2026-08-31까지 입력 $2/출력 $10 프로모)를 검수 재번역 전용으로만 쓰면 $5 크레딧이 꽤 오래 갑니다.

DeepSeek — 가성비 최강, 모드팩 번역 1순위 추천

1. platform.deepseek.com 가입
2. 충전 후 API Keys에서 키 생성
3. moru의 DeepSeek 제공사에 등록

참고: deepseek-chat/deepseek-reasoner 모델명은 2026-07-24에 폐기되고 deepseek-v4-flash/v4-pro로 바뀝니다. moru는 제공사 모델 목록을 실시간으로 불러오므로 목록에서 새 이름을 고르면 됩니다.

OpenRouter — 한 키로 모든 모델

여러 제공사에 가입하기 귀찮다면 openrouter.ai에서 키 하나로 Gemini·GPT·Claude·오픈소스 모델 전부에 접근할 수 있습니다. 소액 수수료가 붙는 대신 모델 실험이 자유롭습니다. moru에서 제공사를 OpenRouter로 고르면 전체 모델 목록이 뜹니다.

moru에 키 등록하기

1. 앱 설정(또는 번역 시작 화면) → 제공사 선택
2. API 키 붙여넣기 — 즉시 해당 제공사의 실시간 모델 목록을 불러옵니다
3. 번역 시작. 키가 유효하지 않으면 첫 요청에서 바로 오류로 알려 줍니다

문제 해결

• 401 / invalid key — 키 복사 시 앞뒤 공백 포함 여부, 폐기된 키인지 확인
• 429 / rate limit — 무료 티어 한도 초과. 잠시 후 재시도하거나 결제를 연결하세요. moru는 자동 재시도를 하므로 대부분 그냥 두면 이어서 진행됩니다
• insufficient balance — 크레딧 소진. 충전 후 이어서 번역하면 TM 덕분에 이미 된 부분은 재과금되지 않습니다