AI 구독과 API 키, 처음부터 연결까지

처음 보는 용어부터

직접 덱을 만들고 공부하는 데 항상 API 키가 필요한 것은 아닙니다. 이 키는 본인 AI 계정으로 생성 기능을 호출할 때 필요합니다.

1. 구독·API·웹 이용권은 서로 다릅니다

API는 프로그램이 AI에 요청을 보내는 연결 방식입니다. API 키는 내 AI 계정의 사용 권한을 증명하는 비밀값입니다. 이메일 로그인 인증번호, 퀴즈노트북 복구키, ChatGPT·Claude 로그인 비밀번호와는 다릅니다.

유료 채팅 구독만으로 이 웹앱의 API 요금이 결제되지는 않습니다. 같은 이메일로 가입해도 청구 계정과 사용량은 따로 확인해야 합니다. API를 쓰기 위해 반드시 유료 채팅 구독부터 살 필요도 없습니다.

2. 나에게 맞는 사용 방식 고르기

이미 쓰는 AI 채팅 앱에서 직접 작업하고 싶다면 자료와 요청문을 그 앱에서 사용하고, 결과를 검토해 가져오는 방식을 선택할 수 있습니다. 이 웹앱의 API 연결과는 별개의 작업이며 가져오기 형식도 확인해야 합니다.

웹앱 안에서 본인 비용으로 후보 문항을 만들려면 BYOK를 사용합니다. API 키와 모델 선택, 비용 관리를 본인이 맡습니다. 이 안내에서 직접 연결을 다루는 제공자는 OpenAI와 Anthropic입니다. Gemini·NotebookLM·Azure·Bedrock의 키를 이 입력란에 넣어도 호환되지 않습니다.

완성 덱 제작을 맡기려면 제작 의뢰권을 선택합니다. 개인 키를 보내지 않습니다. 자료 적합성·제작 범위의 사전 검토, 필요한 추가 합의, 검수·납품 절차를 따릅니다. 현재 정식 접수·판매 개시 여부는 서비스 페이지에서 확인하세요.

3. 연결 전 준비할 것

본인 API 계정, API 결제 설정, 사용할 수 있는 모델 ID, 권한이 확인된 짧은 시험 자료가 필요합니다. 회사·학교 계정은 관리자의 외부 서비스 연결 허가도 확인하세요.

웹앱에서는 이메일 로그인 → 유효한 이용권 확인 → 환경설정·계정에서 기기 등록 및 이용 활성화가 필요합니다. 일반 공개 전에는 버튼이 비활성화되어 있을 수 있습니다. 키를 발급받는 것만으로 기능이 열리지는 않습니다.

키는 이 안내 페이지, 문의 양식, 이메일에 입력하지 않습니다. 실제 연결은 공식 웹앱의 비밀번호 형태 입력란에서만 합니다.

4. OpenAI API 키 발급하기

1. 공식 OpenAI API Platform에 로그인합니다. ChatGPT 구독 설정 화면과 API Platform을 구분하세요.
2. 본인 조직에서 Quiz Notebook용 프로젝트를 만들거나 선택합니다. 다른 업무와 키를 분리하면 사용량 확인과 폐기가 쉽습니다.
3. API Billing에서 결제 수단·크레딧을 확인합니다. 자동 충전(Auto-reload)을 원하지 않으면 끄고 저장 여부를 확인합니다.
4. 프로젝트의 API Keys에서 새 비밀 키를 만듭니다. 이름은 용도를 알아볼 수 있게 지정하고 생성된 키를 안전한 암호 관리자에 보관합니다.
5. 가능하면 필요한 권한만 허용합니다. 이 연결은 Responses API 요청을 생성할 권한이 필요하므로 Read Only만 허용하면 작동하지 않습니다. 관리자용 키는 넣지 마세요.
6. 해당 프로젝트에서 이용 가능한 모델의 정확한 API ID를 공식 모델 목록에서 확인합니다. 채팅 앱의 표시 이름이나 구독 이름을 입력하는 것이 아닙니다.

키를 잃어버렸다면 다시 표시되는지에 의존하지 말고 새 키를 만든 뒤 이전 키를 폐기하세요. 실제 사용 가능 여부는 결제·프로젝트·모델 권한까지 맞아야 확인됩니다.

5. Claude / Anthropic API 키 발급하기

1. 공식 Claude Console에 로그인합니다. Claude 채팅의 Pro·Max 구독 화면과 구분하세요.
2. 본인 조직과 워크스페이스를 확인하고 Billing에서 API 결제를 준비합니다. 자동 충전과 지출 제한 항목이 있다면 의도한 설정인지 확인합니다.
3. API Keys에서 추론 요청에 사용할 키를 생성합니다. 이 웹앱에는 단일 워크스페이스용 키를 사용하세요. 관리자용 키나 별도 클라우드 사업자의 인증정보는 사용하지 않습니다.
4. 키의 이름·권한·만료일을 확인하고 비밀값을 안전하게 보관합니다. 발급한 워크스페이스의 사용량을 나중에 조회할 수 있도록 기록하세요.
5. 공식 모델 문서에서 본인 계정이 사용할 수 있는 모델 ID를 확인합니다. Quiz Notebook에서는 제공자로 Anthropic을 선택합니다.

이미 Claude를 유료로 쓰고 있어도 Console의 API 잔액과 결제 상태는 별도로 확인해야 합니다.

6. 퀴즈노트북에서 연결하고 첫 요청 보내기

1. 공식 웹앱에 로그인하고 환경설정·계정에서 이용권과 현재 기기의 이용 상태를 확인합니다.
2. 나의 덱에서 사용할 덱을 선택합니다. 처음에는 직접 작성한 질문·답 1~2개로 작은 시험 덱을 만드세요.
3. 선택한 덱 아래의 ‘내 API로 AI 후보 만들기’를 펼칩니다. 현재 화면의 API 입력란은 환경설정 안에 있지 않습니다.
4. ‘AI 업체’에서 OpenAI 또는 Anthropic을 고르고 ‘API 모델 ID’와 ‘본인 API 키’를 입력합니다. 앞뒤 공백·줄바꿈을 제거하세요.
5. 전송되는 자료와 별도 API 비용 안내를 읽고 동의합니다. 현재 선택한 덱의 질문·답 텍스트가 전송되며, 이미지·첨부파일을 자동으로 읽어 보내는 기능은 아닙니다.
6. ‘별도 후보 덱 만들기’를 한 번 누르고 기다립니다. 키 입력만으로 AI가 실행되지는 않습니다. 처리가 끝나기 전에 반복해서 누르지 마세요.
7. 생성된 별도 후보 덱을 열어 정답·해설·원자료와의 일치·이용 권한을 확인합니다. 기존 덱에 자동 병합되지 않으며 운영자의 제작대행 검수를 거친 결과도 아닙니다.
8. AI 제공자의 Usage와 Billing에서 이번 요청의 사용량을 확인한 뒤 자료량을 늘립니다. 성공 여부만으로 비용이 없었다고 판단하지 마세요.

7. 내 키와 자료는 어디로 가나요?

요청 흐름은 내 브라우저 → Quiz Notebook 서버 → 선택한 AI 제공자 → 내 브라우저입니다. 키는 요청 처리 중 서버 메모리를 거쳐 전달됩니다. 브라우저에서 AI 회사로만 직접 보내는 방식은 아닙니다.

현재 구현은 API 키를 계정 DB·브라우저 영구 저장소에 저장하지 않으며 요청 본문을 로그에 남기도록 작성하지 않았습니다. 새로고침·로그아웃 시 화면의 키가 지워집니다. 이는 AI 제공자까지 포함한 무보관 보장이나 데이터 이용 정책의 대체 설명이 아닙니다.

비공개 동기화의 암호화와 AI 전송은 별도입니다. AI가 읽을 수 있도록 선택한 텍스트가 제공자에 전달됩니다. 전송 전에 이름·연락처·학생 성적 등 불필요한 개인정보를 제거하고 자료 사용·외부 전송 권한을 확인하세요.

8. 비용과 사용량을 관리하는 방법

API 비용은 모델, 입력·출력 토큰, 실제 호출 수 등에 따라 달라집니다. 토큰은 글자 수와 같지 않습니다. 자료가 길거나 답변이 길고 재시도가 많으면 비용이 늘 수 있습니다. 고정된 덱 1개 가격으로 계산되지 않습니다.

기본 계산은 ‘입력 토큰 × 입력 단가 + 출력 토큰 × 출력 단가’입니다. 공식 요금표의 단위(예: 100만 토큰)를 맞추고 캐시·추론 등 해당 모델의 추가 조건, 세금·환율을 확인하세요. 웹 이용료와 별도로 계산합니다.

OpenAI의 사용 알림은 호출을 중단하지 않습니다. Limits에서 강제 한도(Enforce a hard limit)를 켤 수 있는지 확인하고 의도한 설정을 저장하세요. 강제 한도도 반영 지연으로 소액 초과가 생길 수 있습니다. 자동 충전 한도와 API 지출 한도는 서로 다릅니다.

Claude도 Console의 해당 조직·워크스페이스 사용량, 결제·제한 설정을 확인하세요. 처음에는 작은 자료로 실제 비용을 확인하고, 알림·제한·자동 충전을 각각 점검하세요.

9. 연결 해제·키 교체·구독 취소

1. 웹앱의 ‘입력한 API 키 지우기’를 누르면 이 화면의 키와 전송 동의가 지워집니다. 진행 중 요청은 취소되지 않습니다.
2. 다른 곳에서도 해당 키의 사용을 막으려면 AI 제공자의 API Keys에서 키를 폐기·삭제합니다. 화면에서 지우는 것과 제공자에서 폐기하는 것은 다릅니다.
3. 다시 연결하려면 새 키를 발급받아 입력합니다. 노출이 의심되면 먼저 이전 키를 폐기하고 Usage·Billing에서 모르는 사용 내역을 확인하세요.
4. AI 채팅 구독, API 자동 충전, Quiz Notebook 이용권은 각각 관리합니다. 한 서비스를 취소했다고 나머지 결제 설정까지 자동 해제되지 않습니다.

지원 요청 시 키 원문을 보내지 마세요. 발생 시각, 제공자·모델 ID, 키를 가린 오류 화면이면 확인을 시작할 수 있습니다.

10. 안 될 때 확인할 순서

버튼이 꺼져 있음: 공개 상태, 로그인, 이용권, 전송 동의, 처리 중 여부를 확인합니다. 요청 후 기기 오류가 나오면 등록·활성 상태를 확인합니다.

키·모델·권한 오류: 제공자 선택이 맞는지, 키의 공백·만료·폐기 여부, 프로젝트 권한, 모델 ID를 확인합니다. 채팅 구독 결제만으로 API 잔액 문제가 해결되지 않습니다.

사용 한도·혼잡 오류: 잔액뿐 아니라 속도 제한·지출 한도도 확인하세요. 충전 직후 반영 시간이 필요할 수 있습니다. 오류 원인을 확인하기 전에 추가 결제부터 반복하지 마세요.

시간 초과·결과 형식 오류: 이 웹앱은 자동 재시도하지 않습니다. AI 제공자가 이미 처리해 과금했을 수 있으므로 Usage를 확인한 다음 더 짧은 자료로 다시 시도합니다.

결과 내용이 틀림: API 연결 성공과 정답 검증은 다릅니다. 후보를 원문과 비교해 수정하고 근거 없는 문항은 사용하지 마세요.

11. 계정·저작권·기관 이용

키를 친구·학생과 공유하면 같은 계정에 비용이 발생하고 책임 구분이 어려워집니다. 기관용 구축은 기관 소유 계정·권한·비용 한도를 별도 협의합니다. 문의 양식에 키나 실제 학생 자료를 첨부하지 마세요.

AI 결과는 개인 학습용으로 사용할 것을 권고합니다. 유료 교재·타인의 노트·시험 자료는 외부 AI 전송과 공개·판매가 허용되는지 별도로 확인해야 합니다. 개인용 또는 비공개라는 이유만으로 저작권 문제가 사라지는 것은 아닙니다.

API 키, 이메일 인증번호, 동기화 복구키는 역할이 다릅니다. API 키는 AI 호출, 인증번호는 로그인, 복구키는 암호화한 덱을 여는 데 사용합니다. 서로 바꿔 입력하지 마세요.

12. 자주 묻는 질문

키를 입력하면 바로 과금되나요? 입력만으로는 요청하지 않습니다. 생성 버튼을 눌러 제공자가 처리하면 비용이 발생할 수 있습니다.

AI 구독과 똑같은 결과가 나오나요? 모델·요청문·도구·설정이 달라 동일한 결과를 보장하지 않습니다. 채팅에서 제공되는 검색·첨부 기능이 API 연결에도 자동 포함되는 것은 아닙니다.

매번 키를 입력해야 하나요? 현재 키를 영구 저장하지 않으므로 새로고침·로그아웃 후 다시 입력합니다. 이메일 로그인 유지와 API 키 보관은 별개입니다.

태블릿·데스크탑 설치 앱에도 같은 메뉴가 있나요? 이 문서는 웹앱의 본인 API 연결 기준입니다. 설치 앱의 ‘내 AI로 덱 만들기’와 연결 방식·출시 상태가 다를 수 있으므로 해당 버전 설명서를 확인하세요.