모델 & 환경 설정
AI 프로바이더 & API 키
Gemini, OpenAI, Anthropic API 키를 발급받아 mysnipbox에 연결합니다.
mysnipbox는 내 AI 프로바이더 계정을 그대로 사용합니다(BYOK, Bring Your Own Key). 아래 프로바이더 중 하나에서 API 키를 만들어 앱에 붙여 넣으면 끝이에요. 하나만 있으면 되고, 어디서 시작할지 모르겠다면 Google Gemini를 추천합니다.
Google Gemini (추천)
Gemini Flash를 추천하는 이유
- 빠릅니다: Flash 모델은 속도에 맞춰 만들어져서 이미지 분해 작업에 잘 맞아요.
- 무료 쿼터: 카드 등록 없이 시작할 수 있어요(사용량 제한 범위 내).
- 저렴합니다: Flash는 상위 모델에 비해 단가가 훨씬 낮아서 이미지가 많아도 부담이 적어요.
- Gemini에 맞춰 만들어졌어요: mysnipbox는 Gemini API를 기준으로 설계됐습니다. 무료 플랜은 Google의 분당 호출 한도를 넘지 않게 요청 속도를 맞추고, Auto 모델은 혼잡하거나 종료된 모델을 알아서 처리해요.
API 키 발급받기
- 1Google AI Studio에 접속해 구글 계정으로 로그인합니다.
- 2왼쪽 메뉴에서 Get API key를 누르고 Create API key를 클릭합니다.
- 3기존 Google Cloud 프로젝트를 고르거나, AI Studio가 새로 만들어 주는 프로젝트를 사용합니다.
- 4생성된 키를 복사합니다(보통
AIza로 시작해요). - 5mysnipbox에서 설정 → AI 설정 → 비전 프로바이더를 열고 Google Gemini를 고른 뒤 키를 붙여 넣으세요. 무료 키라면 무료 플랜(Free Tier)을 선택하고, 모델은 Auto(권장)로 두면 됩니다.
비전 프로바이더
Google Gemini (권장)
Gemini API Key
••••••••••••••••••••저장됨변경
macOS Keychain에 로컬 저장됨
플랜
무료 플랜 (Free Tier) - 권장
Google AI Studio 무료 키를 사용합니다. 분당 호출 한도(15 RPM)를 넘지 않도록 2장씩 안전하게 분석합니다.
유료 종량제 플랜 (Pay-as-you-go)
결제 카드가 등록된 프로젝트 키를 사용합니다. 호출 한도가 넉넉하여 최대 3장씩 빠르게 분석합니다.
모델
Auto (권장)
최신 Flash 모델 우선 사용 (지원 불가 시 안정 버전으로 자동 폴백)
Auto 모델을 권장하는 이유
Gemini 모델은 붐비기도 하고, 한도에 걸리기도 하고, 시간이 지나면 종료되기도 해요. 모델을 Auto로 두면 mysnipbox가 이런 상황을 알아서 처리합니다.
- 모델이 붐빌 때(503): 바로 다음 추천 모델로 넘어가고, 붐비는 모델은 5분 동안 쉬게 합니다.
- 쓸 수 없거나 무료 할당량이 끝난 모델: 건너뛰어서 한 곳이 막혀도 작업 전체가 멈추지 않아요.
- 분당 한도(429): 키에 요청을 몰아치지 않고 기다렸다가 다시 시도하며, 무료 플랜은 한도를 넘지 않도록 이미지를 2장씩 분석해요.
- 새 모델과 종료된 모델: 추천 목록이 앱 업데이트 없이 갱신되니 모델 이름을 따라다닐 필요가 없어요.
OpenAI
- 1platform.openai.com에 로그인합니다(ChatGPT가 아니라 API 플랫폼이에요).
- 2Billing에서 결제 수단을 등록하고 크레딧을 선결제로 충전합니다. API 사용료는 ChatGPT 구독과 별도로 청구돼요.
- 3API keys 메뉴에서 Create new secret key를 클릭합니다.
- 4키는 한 번만 보여 주니 바로 복사해 두세요(
sk-로 시작합니다). - 5mysnipbox 설정에서 OpenAI를 고르고 키를 붙여 넣습니다.
Anthropic (Claude)
- 1console.anthropic.com에 로그인합니다(claude.ai가 아니라 개발자 콘솔이에요).
- 2Plans & Billing에서 크레딧을 충전합니다. API 사용료는 Claude 구독과 별도로 청구돼요.
- 3API Keys 메뉴에서 Create Key를 누르고 이름을 붙입니다.
- 4키는 한 번만 보여 주니 바로 복사해 두세요(
sk-ant-로 시작합니다). - 5mysnipbox 설정에서 Anthropic을 고르고 키를 붙여 넣습니다.
API 키는 이렇게 보호됩니다
- 키는 내 기기의 OS 키체인(macOS 키체인 / Windows 자격 증명 관리자)에만 저장됩니다.
- mysnipbox 서버로는 전송되지 않습니다. 키를 받는 서버 자체가 없어요.
- 요청은 내 기기에서 선택한 프로바이더로 바로 전송되고, 중간에 거치는 프록시가 없습니다.
- mysnipbox는 사용료에 마진을 붙이지 않습니다. 프로바이더 요금 그대로 청구돼요.
키 관리 요령
- 채팅, 스크린샷, 공개 저장소에 키를 붙여 넣지 마세요.
- 키가 노출됐다면 프로바이더 대시보드에서 바로 폐기하고 새로 발급하세요.
- mysnipbox 전용 키를 따로 만들어 두면, 다른 도구에 영향 없이 이 키만 폐기할 수 있어요.