Matthewoong Lesson 06 — 무료 API 플레이북 💰
학습자가 끝나면 무료/저비용 LLM API 1개를 본인 환경에 연결해 첫 호출까지 시연한다.
이 스킬은 대화형 강의입니다. 한 청크씩 따라오며 학습자가 어떤 API를 고를지 직접 결정하고, 키 발급 → 안전 보관 → 호출까지 옆에서 가이드합니다. 이 강의는 비용 발생 가능성이 크므로 시작 시점부터 자유 스킵을 강조합니다.
0. 시작하기 전에
| 문서 | 언제 |
|---|---|
_shared/teaching-protocol.md |
이론 청크 |
_shared/guided-practice-protocol.md |
비용 안내 필수 |
_shared/learner-profile-schema.md |
진도·draft |
_shared/style-guide.md |
톤·분기·예시 |
_shared/menu-template.md |
메뉴 |
1. 진입 시 행동
- 학습자 프로필 확인.
progress["06-free-api-playbook"].status분기.- 첫 청크 출력 전 강의 자체 스킵 옵션 제시 —
_shared/guided-practice-protocol.md의 비용 투명성 섹션 참조.이 강의는 비용 발생 가능성이 큰 실습이 포함돼요. 부담되시면 강의 자체를 스킵하셔도 돼요. 13강에서 무료 로컬 LLM 옵션도 다뤄요. (1) 그래도 진행 (무료 옵션 우선) (2) 강의 스킵 → 다음 강의로 - 첫 인사.
- 이론 진입. 헤더
📘 [Lesson 6 · 청크 X/Y]. - 이론 끝 → 가이드 실습 (옵션 ≥3개 →
practice/options/). - 실습 종료 → 진도 갱신 + 다음 강의(7강).
2. 진도 갱신 + draft 키 명세
| 시점 | 갱신 |
|---|---|
| 6강 첫 진입 | status = "in_progress", current_chunk = 1 |
| 청크 통과 | current_chunk += 1 |
| 청크 3 답변 | draft.chosen_provider = <Anthropic/Google/OpenRouter/...> |
| 청크 4~5 답변 | draft.free_tier_limits_noted = <학습자가 확인한 무료 한도> |
| 가이드 실습 호출 성공 | draft.first_call_result = <첫 호출 결과> |
| 실습 통과 | practice_status = "done", status = "completed" |
| 강의 자체 스킵 | status = "skipped", practice_status = "not_done" |
6강이 사용하는 draft 키
| 키 | 시점 | 형식 |
|---|---|---|
chosen_provider |
청크 3 | string |
free_tier_limits_noted |
청크 4~5 | string (확인한 무료 한도) |
first_call_result |
실습 | string |
3. 이론 lesson 흐름
청크 8개. 현재 무료 정책은 자주 바뀌므로 학습자에게 직접 확인을 요청.
6강에서 왜 한 청크씩 가는가
API 발급은 비용 결정이라 학습자가 매 단계에서 멈출 수 있어야 합니다. 한 번에 다 보여주면 부담을 못 느끼고 진행하다가 나중에 청구서를 보고 놀라요. 한 청크씩 비용 확인 → 다음으로 가야 학습자가 안심하고 통제하며 진행할 수 있습니다.
4. 가이드 실습 — 3개 옵션 (practice/options/)
4-0. 진입 시 draft 정리
🎉 이론 끝! 이제 진짜로 키를 발급해볼 시간이에요.
📝 고른 제공자: <draft.chosen_provider>
📝 확인한 무료 한도: <draft.free_tier_limits_noted>
다시 한번 알려드려요 — 무료 한도는 자주 바뀌니 가입 페이지에서 *현재
정책*을 직접 확인해주세요. 진행하시겠어요?
4-1. 옵션 제시 (3개)
어떤 제공자로 진행하시겠어요?
(1) Anthropic Claude — 신규 가입 시 일정 크레딧 (변동 가능)
(2) Google AI Studio (Gemini) — 일정 RPM·일일 한도 무료 (변동 가능)
(3) OpenRouter — 일부 모델 무료 티어 (변동 가능)
번호로 답해주세요. 비용이 부담되시면 "스킵"이라고 답하셔도 돼요.
각 옵션 → practice/options/anthropic.md / google-ai-studio.md / openrouter.md 로드.
4-2. 가이드 실습 7단계
_shared/guided-practice-protocol.md 그대로:
- 옵션 선택
- 사전 점검 — 카드 정보 필요 여부, 학습자 부담 재확인
- 💰 비용 안내 의무 — 표준 안내문 + (1) 진행 / (2) 스킵 / (3) 무료 옵션 더 알아보기 분기
- 키 발급 단계 안내 (학습자가 직접 가입 페이지로 이동)
- 키 안전 보관 — 환경 변수,
.env, 절대 코드에 직접 박지 않기 - 첫 호출 (학습자 OS 맞춤)
- 검증 + 마무리
4-3. 검증 기준
| 항목 | 통과 기준 |
|---|---|
| 키가 안전한 위치에 보관됨 | ✅ |
| 첫 호출이 성공 (응답 수신) | ✅ |
| 학습자가 비용 추적 방법을 안다 (대시보드 위치 등) | ✅ |
3개 중 2개 이상 ✅.
4-4. 트러블슈팅
401/403 에러 → 키 잘못 복사. 429 → 한도 초과. 결제 정보 누락 → 가입 페이지 재확인.
5. 자리표시자 처리
1강 동일.
6. 도구 비종속
도구별 환경 변수 등록 방식 차이는 부록.
7. 종료 시 행동
- 진도 갱신.
- 비용 추적 안내 — 학습자가 언제든 사용량 확인 가능함을 한 번 더 강조.
- 다음 강의 안내 — 7강(debugging).
8. 강의 작성자 메타
- 트랙: 기초 6강
- 선행: 1~5강 (권장)
- 분량: 약 30분
- 외부 자료 의존: 학습자가 가입할 외부 LLM 서비스
- 💰 비용: 큼 (변동 가능, 강의·실습 모두 자유 스킵)
- 학습 목표:
- 무료 LLM API 1개를 본인 환경에 연결
- 키를 안전하게 보관하는 방법을 안다
- 비용 추적 방법을 안다
- 다음 강의: 07-debugging
9. 빠른 자기 점검
- 학습자 프로필 읽음
-
📘 [Lesson 6 · 청크 X/Y] - 한 청크만, 끝에 ❓/🛠/🔀
- 자리표시자 채움
- 도구명 노출 X
- 시도 전 답 X
-
progress["06-free-api-playbook"]갱신 - 6강 추가: 비용 발생 가능성을 언급할 때마다 자유 스킵 옵션을 함께 제시했는가