선생님과 학생 모두를 위한 완전한 사용 설명서
AI 시 추천, AI 글감 추천, AI 첨삭·수정·이어쓰기, AI 기사 생성, AI 퀴즈, AI 음악 추천 기능 모두 Google Gemini 2.5 Flash를 사용합니다. API 키 없이도 기본 활동(감정 선택, 글쓰기, 직접 입력)은 가능하지만 AI 기능은 키가 필요합니다.
Google AI Studio 무료 티어 — 분당 15회, 하루 1,500회 무료. 수업 활용에 충분합니다.
Chrome에서 아래 주소로 이동 후 Google 계정으로 로그인
왼쪽 메뉴 Get API key → Create API key 클릭
AIzaSy...로 시작하는 키를 복사해 안전하게 보관
4개 앱 중 아무 곳에서나 한 번만 "선생님이신가요?" → 교사 패널 → Gemini API 키 입력 → 저장. 나머지 3개 앱에도 자동으로 반영돼요.
API 키는 개인 정보입니다. SNS·공개 게시물에 올리지 마세요. 학생 기기에는 선생님이 직접 입력해 주세요.
학생 로그인 화면의 반/모둠 선택은 고정 목록이 아니라 선생님이 직접 만드는 이름이에요. "다詩", "3반 시창작반"처럼 원하는 이름을 자유롭게 만들 수 있어요. 교사 패널의 "🏷️ 반/모둠 이름 관리"에서 추가·삭제하면, 4개 앱 학생 로그인 화면에 똑같이 나타나요.
4개 앱은 같은 Firebase 프로젝트(eaim-classroom)에 연결되어 있어요. 선생님이 컴퓨터에서 만든 반 이름이 학생들 각자 폰에도 바로 나타납니다.
지금 느끼는 감정이나 주제를 입력하거나, 12개 감정 칩 중 하나를 클릭해요.
Gemini AI가 감정에 어울리는 한국 시 3편을 추천해줘요. 마음에 드는 시를 클릭해 선택하세요.
시 전문을 읽으며 느낀 감정을 15개 탭 중 여러 개 클릭해요.
왜 그런 감정이 들었는지 자유롭게 써요. AI 첨삭으로 피드백을 받을 수 있어요.
읽은 시에서 영감을 받아 나만의 시를 써봐요. AI 첨삭·영감받기를 활용할 수 있어요.
모든 활동이 한 페이지에 모여요. 인쇄하거나 텍스트로 저장할 수 있고, "📰 신문으로 보내기"로 나만의 시를 신문 앱 기사 재료로 보낼 수도 있어요.
배경음악을 선택하고 TTS로 시를 낭독해요.
오늘의 경험·감정
경험을 생생하게
마음 전하기
근거로 설득
정보를 구조적으로
사건과 인물 창작
장르를 선택하면 Step 3 개요 구조가 자동으로 바뀌어요.
6가지 장르 중 하나를 선택하고, 주제를 입력해요.
장르와 주제에 맞는 구체적 글감 3가지를 추천해줘요.
장르에 맞는 개요 구조에 메모해요.
AI 도구 4종(수정·첨삭·이어쓰기·다음 내용 제안)을 사용할 수 있어요.
전체 글을 종합 첨삭하거나 다듬어요. 적용 여부는 학생이 직접 선택해요.
인쇄하거나 텍스트 파일로 저장해요. "📰 신문으로 보내기"로 완성한 글을 신문 앱 기사 재료로 보낼 수도 있어요.
배경음악과 함께 완성된 글을 TTS로 낭독해요.
신문 이름(AI 추천 가능)·발행일·호수를 정하고, 4가지 스타일(조선일보형·2단 컬러형·복고형·타블로이드형) 중 골라요.
기사 추가 방식이 3가지예요: "🤖 AI 자동 생성"(주제·섹션·유형·길이 지정), "✏️ 직접 입력(모둠)", "📥 가져오기"(시·글쓰기 앱에서 보낸 내 글 불러오기). 섞어서 기사를 여러 개 추가해요. 기사마다 "🎨 AI 삽화 생성"으로 흑백 신문 일러스트도 넣을 수 있어요.
선택한 스타일로 신문이 자동 조판돼요. 복사·저장·인쇄 가능해요.
신문을 만들며 느낀 점을 쓰고 AI 첨삭·도움받기를 활용해요.
신문 기사들을 주제로 한 노래 가사와 수노(Suno AI) 프롬프트를 생성해요.
"직접 입력" 탭은 모둠원별로 기사를 나눠 쓰고 기자 이름을 남길 수 있어, 모둠 협업 신문 제작에 특히 잘 맞아요.
시 감상&창작·글쓰기 창작 앱 완성 화면에서 "📰 신문으로 보내기"를 누르면, 신문 앱 "📥 가져오기" 탭에서 같은 이름으로 로그인한 학생 본인의 글만 불러올 수 있어요. 자기 시나 글을 신문 기사로 재활용할 수 있는 거예요.
속담 · 관용어 · 한자성어 · 순우리말 · 문학어휘 · 맞춤법, 총 72개 어휘가 기본 내장되어 있어요. 로비에서 카테고리별로 원하는 어휘만 골라 게임에 사용할 수 있어요.
설명이 맞으면 O, 틀리면 X
30초 안에 최대한 많이!
뜻을 보고 어휘를 직접 입력
어휘와 뜻 짝지어 맞추기
뜻을 보고 4지선다
AI가 매번 새 문제를 출제
두 팀이 번갈아 대결
AI가 만든 이야기 속 어휘 찾기
로비 화면에 오늘의 랭킹 TOP 5가 표시돼요. 게임을 마치면 점수가 자동으로 기록됩니다.
감정 분석 후 교과서 시인 중심 3편 추천
잘한 점·고칠 점·표현 제안
시적 표현·시어 추천
첫 행 예시·이미지 제안
분위기 분석 후 낭독용 배경음악 4곡
장르·주제 맞춤 글감 3가지
단계별 내용 구체적 제안
자동 다듬기 → 적용/취소 선택
피드백만 제공, 글 변경 없음
다음 2~3문장 제안
전체 글 개선 → 적용 선택
어울리는 이름 5가지 제안
주제·섹션·유형·길이 지정해 기사 완성
기사마다 흑백 신문 일러스트 생성
피드백 및 시작 문장 힌트 제공
기사 내용으로 가사·프롬프트 생성
다른 AI 기능은 전부 텍스트 모델(gemini-2.5-flash)을 쓰지만, AI 삽화만 이미지 생성 전용 모델(gemini-2.5-flash-image)을 별도로 호출해요. 같은 API 키로 자동 작동합니다.
예문·반의어·비슷한 표현 등 매번 새 문제
어휘가 담긴 짧은 이야기를 즉석 생성
모든 AI 기능은 선택 사용입니다. 학생이 직접 쓰는 것이 기본, AI는 막힐 때 참고하는 도구로 활용해 주세요.
시/글의 분위기를 분석해서 어울리는 음악 4곡을 추천해요. 카드 클릭 → 검색어 복사 → 유튜브에서 검색 → URL 복사 → 유튜브 탭에 붙여넣기
영상이 퍼가기 차단된 경우예요. 다른 영상으로 교체하거나 파일 업로드 방식을 사용하세요.
시·글쓰기 앱에서 배경음악과 동시에 TTS(Text-to-Speech)로 한국어 낭독을 지원해요.
TTS는 Chrome에서 가장 자연스럽게 작동합니다. iOS Safari도 지원해요.
이름 입력 모달 하단 "선생님이신가요?" 클릭
기본 비밀번호 1234 입력
반/모둠 이름 관리 · API 키 설정 · 학생 현황 확인 · CSV 내보내기 · 전체 초기화 가능
교사 패널의 "반/모둠 이름 관리"에서 원하는 이름(예: "다詩", "3반 신문반")을 추가하면, 학생 로그인 화면 선택지에 바로 나타나요. 삭제도 가능해요. 4개 앱이 같은 목록을 공유하므로, 한 앱에서 만든 이름이 나머지 앱에도 똑같이 보여요.
이름 추가·삭제, 4개 앱 공유
한 곳에서 저장하면 4개 앱 모두 적용
이름·단계·글자수·최근 활동 시각 확인
전체 학생 활동 데이터를 엑셀로 저장
새 반 수업 전 데이터 삭제
시·글쓰기·신문·게임 앱은 같은 Firebase 프로젝트(eaim-classroom)를 사용해서, 반/모둠 목록과 "신문으로 보내기"한 글이 학생 기기가 달라도 실시간으로 공유돼요. API 키는 한 곳에서만 설정하면 됩니다. 단, 각 앱의 학생 활동 기록(누가 어디까지 썼는지)은 기기별로 따로 저장돼요.
github.com 접속 → 로그인
Add file → Upload files → 위 6개 HTML 파일을 드래그앤드롭 → Commit
서로 링크로 연결돼 있어서, 파일명을 바꾸면 이동 버튼이 깨져요. 꼭 같은 이름으로 덮어쓰세요.
Settings → Pages에서 Source가 main / (root)로 되어 있는지 확인
배포 완료 후 아래 주소로 접속 가능. qr.io 등에서 QR코드 생성!
AIzaSy...로 시작하는지, 앞뒤 공백이 없는지 확인해 주세요. 4개 앱 중 하나에만 입력하면 나머지에도 자동 반영돼요.gemini-2.5-flash-image 모델을 따로 호출해요. 같은 API 키를 쓰지만 이미지 생성 권한이 막혀있는 키라면 실패할 수 있어요. Google AI Studio에서 발급한 일반 키라면 보통 문제없이 작동해요.
Emotion · Artscape · Interactive · Musicalization
박성애 선생님 제작 · Powered by Gemini AI