내 API 키로 연결

내 API 키로 연결은 무엇인가요?

어느 서비스 키를 쓸까요?

• 제미나이(Google AI Studio) — 구글 계정만 있으면 바로 키를 받고 무료 사용량으로 시작합니다. 처음이라면 이것을 추천합니다. 결제를 연결하면 쓴 만큼 구글에 청구됩니다.
• 오픈라우터(OpenRouter) — 키 하나로 Anthropic·OpenAI·Google 모델을 골라 씁니다. 미리 충전한 금액에서 빠지고, 다 쓰면 멈춥니다.
• 오픈코드 Zen — 오픈코드 콘솔에서 충전하고 쓴 만큼 냅니다. 자동 충전은 콘솔에서 끌 수 있습니다.
• 오픈코드 Go — 월 구독($10·$40)으로 정해진 사용량 안에서 씁니다. 원래 오픈코드 앱을 위한 요금제라, 쌤핀에서는 쓸 수 있는 모델(GLM·Kimi·DeepSeek 등)만 보입니다.

연결하는 법

1. 1설정 > AI 연결 로 들어갑니다. 맨 위에 「내 API 키로 연결」 카드가 있습니다.
2. 21단계에서 서비스를 고릅니다.
3. 32단계 [키 받으러 가기]를 누르면 그 서비스의 키 만드는 페이지가 브라우저로 열립니다. 카드에 적힌 순서대로 키를 만들고 복사합니다.
4. 43단계 칸에 붙여 넣고(Ctrl+V) [연결 확인]을 누릅니다. 따옴표나 앞뒤 빈칸이 섞여도 알아서 걷어 냅니다.
5. 5"연결됐어요"가 뜨면 끝입니다. 추천 모델이 자동으로 골라지고, 쌤핀 AI 패널이 바로 「내 API 키」로 답합니다.

쓰는 곳

• 쌤핀 AI 패널 — 위쪽 고르는 상자에서 「내 API 키」를 고르고, 옆 상자에서 모델을 바꿀 수 있습니다. 답 아래에 "내 API 키 · 모델 이름"이 표시됩니다.
• 생기부 초안·분량 조절 — 오른쪽 [AI 초안] 패널에서 「내 API 키」를 고르면 됩니다.
• 근거 정리 보드의 AI 주제 묶기·근거 지도 제안도 같은 키로 합니다.
• 모델은 설정 > AI 연결 의 키 카드에서도 바꿀 수 있습니다. 「추천」 모델은 빠르고 값이 쌉니다. 생기부 초안 품질이 아쉬우면 더 큰 모델로 바꿔 보세요.
• 이 방식으로는 아직 이미지를 보낼 수 없습니다.

키는 어떻게 보관되나요?

• 이 컴퓨터에만, 운영체제 암호화(윈도우·맥의 보안 저장소)로 보관합니다. 쌤핀 서버·백업 파일·구글 드라이브 동기화로 보내지 않습니다.
• 화면에는 끝 4자리만 보입니다. 저장한 키를 다시 꺼내 보여 주는 기능은 없습니다.
• 질문과 자료는 쌤핀 서버를 거치지 않고 고른 서비스의 정해진 주소로만 갑니다. 학생 이름은 ［이름1］처럼 가려서 보냅니다.
• 다른 서비스의 키를 잘못 넣으면 보내지 않고 알려 드립니다. 저장한 뒤 클립보드에 남은 키도 지웁니다.
• 요금이 갑자기 불어나지 않게, 한 컴퓨터에서 1분 30번·하루 600번까지만 보냅니다.

안내 문구별 해결

• "서비스가 이 키를 받아 주지 않았어요" — 키를 끝까지 복사했는지, 고른 서비스가 맞는지 확인하세요. 서비스 사이트에서 키를 지웠다면 새로 만들어 넣으세요.
• "…키처럼 보여요" — 다른 서비스의 키입니다. 1단계에서 그 서비스를 고르고 다시 확인하세요.
• "남은 금액이 없어요" — 서비스 사이트에서 충전하세요(오픈라우터·오픈코드 Zen).
• "요청이 몰렸거나 사용 한도에 닿았어요" — 잠시 뒤 다시 하거나, 제미나이라면 결제를 연결하세요.
• "고른 모델을 이 키로는 쓸 수 없어요" — 설정 > AI 연결 에서 다른 모델(추천)을 고르세요.
• "AI 서비스에 연결하지 못했어요" — 인터넷 연결을 확인하세요.

키 지우기