본문으로 건너뛰기
원포트 AI

채팅 앱으로 쓰기 (개발 없이)

코드를 안 써도 돼요. 앱에 주소와 키만 넣으면 돼요.

AI 에게 넘기기ChatGPT 에서 열기 (새 창)Claude 에서 열기 (새 창)원문 열기

키 받기 링크를 받은 지갑 주인이 프로그램 없이 대화만 하시려면 그 링크를 연 화면의 「웹에서 바로 대화」가 제일 빨라요 — 설치할 것이 없어요. 그 칸의 「로그인 링크 받기」를 누르면 로그인 링크는 지갑 주인 메일로만 가요(화면에 가린 주소가 보여요). 그래서 이 링크를 선생님께 전달해도 선생님은 웹 대화로 못 들어가요 — 선생님이 웹으로 쓰시려면 아래 「팀과 한도」로 초대하세요. 그 칸이 아예 없으면 링크를 받은 메일이 지금 지갑 주인이 아니거나(담당자를 넘긴 뒤 등) 그 메일로는 로그인할 수 없는 경우예요 — 아래처럼 채팅 앱에 키를 넣어 쓰세요. 쓰시던 채팅 앱이 있다면 그 앱에 주소와 키를 넣어 한 키로 여러 회사 모델을 골라 쓰셔도 돼요. 다만 GPT · 클로드 팩으로 산 크레딧이면 제미나이는 안 불려요(403 model_not_in_plan). 키 받기 화면의 「부를 수 있는 모델」 줄이나 앱의 모델 목록(아래)에서 확인하세요.

앱에 넣을 값#

넣는 곳값
API 제공자 / ProviderOpenAI (또는 OpenAI 호환 · Custom)
Base URL / API Hosthttps://oneport.kr/v1
API Keysk-so- 로 시작하는 발급받은 키
Model목록에서 고르거나 /v1/models 의 id 를 그대로

Chatbox 는 「API 호스트」에 https://oneport.kr/v1 을 넣고 「API 경로」는 /chat/completions 그대로 두세요(Chatbox 는 호스트가 /v1 로 끝나면 /v1 을 더 붙이지 않아요 · 앱 동작). 저장한 뒤 모델 칸의 「가져오기」를 누르면 목록이 채워지고, 답 길이는 「대화 설정」의 「최대 출력 Tokens」에서 정해요(앱 동작 · 10-31 Chatbox 공개 소스 기준). 앱이 주소 뒤에 /v1 을 스스로 붙이면(Cherry Studio 가 그래요 · 앱 동작) 404 「주소에 /v1 이 두 번 들어갔어요」가 와요. 그땐 Base URL 을 https://oneport.kr 까지만 넣으세요 — 오류 문장 끝에도 「채팅 앱이 주소 뒤에 /v1 을 스스로 붙이면 Base URL 을 https://oneport.kr 까지만 넣으세요.」가 와요(그 앞의 「base_url 을 https://oneport.kr/v1 까지만」은 SDK 에 넣을 값이에요). 반대로 https://oneport.kr 까지만 넣으면 모델 목록을 부를 때부터 404 「주소에 /v1 이 빠졌어요」가 와요 — 앱에 따라 목록이 비거나 알 수 없는 오류로만 보여요. 그땐 /v1 을 다시 붙이세요.

어떤 앱을 쓰나요#

「OpenAI 호환 주소를 직접 넣을 수 있는」 채팅 앱이면 됩니다. Chatbox · Cherry Studio · Jan 같은 앱이 그런 설정을 제공해요. 주소만 열어 쓰는 채팅 웹사이트는 연결이 안 돼요 — 브라우저가 저희 주소를 바로 부르는 화면은 기본으로 막혀요(키가 페이지에 실리니까요). 모델 목록을 불러올 때 401 · 404 같은 번호 없이 연결 오류(Failed to fetch 등)만 뜨면 대개 이 경우예요 — 다만 이 오류로는 주소 · 키가 맞는지 알 수 없어요(키를 실은 요청이 저희에게 오기 전에 멈춰요). 주소 글자가 맞다면 설치한 앱으로 바꾸거나 앱의 네트워크 설정(아래 폰 문단)을 켜세요. 아래 Open WebUI · LibreChat 은 기관이 올린 서버가 저희를 불러서 브라우저로 써도 돼요(앱 동작). 학교에서 여러 분이 설치 없이 쓰시려면 아래 「팀과 한도」 초대가 가장 간단해요 — 웹 대화 화면은 저희가 드려요.

폰에서는 Chatbox 앱(안드로이드 · 아이폰)을 쓰세요. 제공자를 추가할 때 「API 모드」를 「OpenAI API 호환」으로 두고 위 네 칸을 넣은 뒤, 같은 설정의 「네트워크 호환성 개선」을 꼭 켜세요. 꺼 두면 앱이 안의 웹 화면으로 저희를 불러서 위처럼 막혀요(앱 동작 · 10-31 Chatbox 공개 소스 기준 · 저희가 폰으로 시험하지는 않았어요). 맥 · 윈도우 Chatbox 는 이 설정 없이도 돼요(앱 동작 · 같은 소스 기준). 그래도 안 되면 위 웹 대화(https://schoolorder.kr/ai)를 폰 브라우저로 쓰세요.

  • 혼자 또는 소수 — 앱을 하나 설치하고 위 네 칸을 넣으면 바로 시작돼요.
  • 서버를 직접 올릴 수 있으면 — 학교·기관에서 여러 명: Open WebUI·LibreChat 같은 오픈소스 웹 화면을 기관이 한 번 올려 두면, 구성원은 설치 없이 브라우저로 들어와 쓰게 돼요. 계정 관리와 이용 기록도 그 화면에서 한 번에 봐요.

여러 분이 같은 지갑을 쓰시면 키를 사람마다 나눠 주세요. 키 하나를 돌려 쓰면 누가 얼마나 썼는지 갈리지 않고, 한도도 같이 닿아요. 지갑 주인이 산 곳 대시보드의 AI API 화면(스쿨오더면 https://schoolorder.kr/dashboard/api)의 「새 키 발급」에서 키 이름에 선생님 이름을 적고 「키 만들기」를 누르세요.

  • 초·중·고 학교 지갑은 「새 키 발급」과 「여러 개 발급」에 쓰임새 「선생님」이 먼저 골라져 있어요. 학생에게 나눠 줄 키는 「학생」을 누르고 만드세요. 키를 하나 만들 때마다 쓰임새가 다시 「선생님」으로 돌아가요 — 학생 키는 만들 때마다 「학생」을 눌러 주세요. 「학생」으로 만들면 월 150 크레딧 한도가 걸리고 웹 검색 · 웹 페이지 읽기 · 다른 서버의 도구(원격 MCP) · 영상 만들기 · jev · 작업(/v1/tasks)이 꺼져요 — 앱이 답 길이(최대 토큰)를 안 정하면 claude-opus-5-5 는 답 하나를 8,192 토큰으로 미리 잡는 몫이 월 한도(150 크레딧)를 넘어 첫 질문부터 429 예요(셈은 아래 「한도에 닿으면」 · 10월 기준). 최대 토큰을 2,000 으로 두면 출력 몫이 약 37 크레딧이라(보낸 글 몫만 더해요) 첫 질문이 지나가요. 학생 키로 큰 모델을 쓰려면 「한도 수정」에서 월 한도를 올리거나, 가벼운 모델을 고르거나 앱의 답 길이를 줄이세요. 이미 「학생」으로 만들었으면 키 줄의 쓰임새를 「선생님」으로 바꾸세요 — 월 한도가 학생 기본값(150 크레딧) 그대로면 같이 풀려서 지갑 잔액까지 써요(손으로 적은 한도는 그대로예요).
  • 「키 만들기」엔 한도 칸이 없어요 — 선생님 키는 그대로 두면 지갑 잔액까지 써요. 한도를 걸려면 만든 뒤 그 키 줄의 「한도 수정」에서 월 · 하루 한도와 기한을 넣으세요(「이 날까지 사용」은 그날 끝까지 쓰고 다음 날 한국 시간 0시에 꺼져요). 키를 하나 만들면 원문 칸의 「보관했어요」를 눌러야 키를 또 만들 수 있어요. 만들면서 한도를 같이 거는 건 「여러 개 발급」이에요(이름에 번호를 붙여 한 번에 만들고 원문을 CSV 로도 받아요 — 초·중·고 학교 지갑은 쓰임새 「선생님」 · 이름 앞머리 「선생님」이 미리 채워져 있고 한도 · 「만들 개수」는 비어 있어요. 쓰임새를 「학생」으로 바꾸면 손대지 않은 앞머리는 「학생」으로, 한도는 월 150 크레딧로, 「만들 개수」는 20 으로 따라 바뀌어요(「선생님」으로 돌아가면 다시 비어요). 만들 개수는 나눠 줄 사람 수로 적으세요 — 비운 채 누르면 「만들 개수를 1 이상의 정수로 적어주세요.」가 떠요). 이 칸에선 키별 월 한도 · 하루 한도 · 「이 날까지 사용」을 같이 넣어요. 대시보드에선 키 이름을 나중에 못 바꿔요 — 선생님 이름을 넣으려면 「새 키 발급」으로 한 분씩 만드세요.
  • 키 줄마다 이번 달 사용과 한도가 보여요. 켜진 키는 지갑 하나에 보통 50개까지예요(「팀과 한도」로 초대한 분의 대화 자리도 같이 세요). 넘으면 「키 자리를 모두 쓰고 있어요」가 떠요 — 안 쓰는 키를 폐기하면 자리가 돌아와요.
  • 설치 없이 쓰시려면 같은 화면 「팀과 한도」에서 함께 쓸 분을 초대하세요. 그분께 시작 링크 메일이 가고, 누르고 비밀번호를 정하면 웹 대화로 들어가요. 다음부터는 https://schoolorder.kr/ai 에서 초대받은 메일로 로그인해요 — 「안내 한 장」에도 이 주소가 있어요. 대시보드 지갑(학교 · 대학 · 기업)의 초대 자리는 처음 20자리예요. 「함께 쓰는 사람」에서 직접 늘리면 50에서 초대 밖 키 수를 뺀 만큼까지 돼요 — 켜진 키와 초대한 분(아직 안 들어온 분 포함)을 합쳐 50을 못 넘어요. 지갑 주인이 웹 대화를 열어도 한 자리를 써요. 초·중·고 학교 지갑은 초대 칸도 「선생님」이 먼저 골라져 있어요. 메일 여러 개를 한 칸에 그대로 붙여 넣고 한 번에 보내요(남은 자리만큼 가요). 학생을 초대할 땐 「학생」을 고르고, 한 번 보내면 칩이 다시 「선생님」으로 돌아가니 다음 학생 묶음도 「학생」을 다시 골라요. 초·중·고 지갑과 대학으로 등록되지 않은 학교 · 기관 지갑의 초대는 쓰임새와 상관없이 그 학년도 보호자 동의 확인이 먼저예요(대학 · 기업 지갑은 확인 없이 열려요) — 확인 전이면 선생님만 초대해도 「초대하기 전에 「함께 쓰는 사람」 위에서 보호자 동의 확인을 해 주세요. 선생님만 초대할 때도 필요해요.」가 떠요. 학교 담당자가 같은 화면 「함께 쓰는 사람」 맨 위 보호자 동의 칸에서 문장에 체크하고 「확인했어요」를 누르면 초대가 열려요(선생님 키는 확인 없이도 만들 수 있어요). 체크하는 문장은 「만 14세 미만 학생은 보호자의 서면 동의(회신서)를 받아 학교에 보관하고 있어요. 요청하시면 회신서를 받았는지 확인해 드릴게요.」예요. 확인은 학년도(3월 1일~다음 해 2월 말)마다 해요. 사람마다 걸 수 있는 건 이번 달 한도 하나예요 — 하루 한도와 기한은 키에만 있어요. 그 한도는 그분이 들어온 뒤 「사람마다 한도 · 쓰임새」에서 걸어요 — 「학생」으로 초대해도 기본 한도는 안 걸려요. 한도를 걸기 전에는 그분도 지갑 잔액까지 써요. 사람마다 건 한도는 키 월 한도와 같이 답 하나를 보내기 전에 미리 맞대 봐서, 조금 남아 있어도 막힐 수 있어요. 매달 1일 한국 시간 0시에 다시 열려요. 닿으면 웹 대화에 「이번 달 내 한도로는 보낼 수 없어요. 담당자에게 한도를 늘려 달라고 해 주세요.」가 떠요(「학생」으로 초대한 분은 「선생님께 …」). 학교 지갑에선 사람마다 쓴 양은 안 보여요. 아직 안 들어온 분은 그 줄의 「메일 다시 보내기」로 시작 링크를 다시 보내요. 사람을 빼려면 「빼기」를 누르세요 — 그분의 웹 대화가 꺼지고 자리가 돌아와요. 「학생」으로 잘못 초대했으면 바로(들어오기 전에도) 「사람마다 한도 · 쓰임새」에서 그분 줄의 쓰임새를 「선생님」으로 바꿔요.
  • 대시보드 지갑엔 키나 사람마다 부를 모델을 고르는 칸이 없어요 — 비싼 모델은 한도로 막으세요(「학생」 쓰임새도 검색 · 영상 · jev 같은 기능만 꺼요).
  • 「팀과 한도」 아래 「함께 쓰는 분께 나눠 드릴 안내 한 장」을 인쇄해 나눠 드리면, 웹 대화 주소 · API 주소 · 지켜 주실 것 · 막힐 때 할 일이 한 장에 있어요(키 원문은 안 실려요).

초대와 키, 무엇이 다른가요#

내 지갑이 어느 쪽인지는 「팀과 한도」의 한도 카드 제목으로 알아요 — 「사람마다 한도 · 쓰임새」면 학교 지갑, 「이번 달 사용량」이면 대학 · 기업 지갑이에요. 대학 · 연구실인데 학교 지갑으로 보이면 admin@schoolorder.kr 로 대학 지갑으로 바꿔 달라고 말씀해 주세요.

견줄 것「팀과 한도」 초대사람마다 키
쓰는 곳웹 대화(설치 없음)채팅 앱에 키를 넣어요
한도이번 달 한도 하나 — 그분이 들어온 뒤 「사람마다 한도 · 쓰임새」(기업 · 대학 지갑은 「이번 달 사용량」)에서월 · 하루 한도와 기한 — 키 줄의 「한도 수정」에서
쓴 양학교 지갑은 사람마다 안 보여요(기업 · 대학 지갑은 보여요)키 줄마다 이번 달 사용이 보여요
자리같은 키 자리를 써요(보통 지갑 하나에 50자리)같은 키 자리를 써요(초대한 분께 키를 따로 주면 그분은 두 자리)

대화는 누가 보나요#

「팀과 한도」로 들어온 분의 웹 대화는 사람마다 따로예요 — 같은 지갑의 다른 선생님도, 지갑 주인도 대화 내용은 못 봐요. 대시보드에는 대화 내용 없이 사람마다 한도가 보여요 — 쓴 양은 학교 지갑이면 들어온 분이 3명 이상일 때 팀 합계로만, 기업 · 대학 지갑이면 사람마다 보여요. 웹 대화는 다시 볼 수 있게 그 지갑이 없어질 때까지 저장해요 — 목록에서 지운 대화와 「빼기」로 뺀 분의 대화도 그분 메일과 함께 남아요. 완전히 지우려면 개인정보처리방침(https://schoolorder.kr/privacy) 7항의 방법으로 요청해 주세요. 채팅 앱이든 웹 대화든 글은 고른 모델의 회사로 가요 — 맡기는 회사와 나라는 같은 방침 5항 · 6항에 있고, 대학 지갑이면 AI API 화면 「본부·사업단에 낼 것」에서 위탁 · 국외이전 명세를 받아요. 채팅 앱으로 부른 글은 저희가 본문을 저장하지 않아요 — 대화 기록은 그 앱에 남아요(앱 동작).

일부 대화만 같이 보기#

웹 대화의 「프로젝트」를 쓰세요. 프로젝트를 만들고 「공유」에서 같이 볼 선생님 메일을 초대해요(원포트에 가입한 메일만 · 50명까지). 프로젝트 안 대화에서 잘 나온 답 아래 「프로젝트 자료에 넣기」를 누르면, 그 답이 프로젝트 자료로 들어가 초대한 분도 봐요. 초대받은 분도 프로젝트 파일과 텍스트를 넣고 뺄 수 있어요. 대화 목록은 계속 각자의 것이에요.

처음 고를 모델#

목록은 값 순서가 아니에요 — 10월 기준 맨 위 claude-fable-5-1 은 채팅 모델 가운데 가장 비싼 축이에요. 둘째 jev 는 고른 모델 값으로 빠지고, 목록 단가(출력 100만 토큰당 약 45,990 크레딧)는 가장 비싼 후보 기준의 최대값이에요 — 잔액이나 한도가 빠듯하면 그 안에 드는 값싼 후보 안에서 골라서 막히지 않아요(가장 값싼 후보로도 안 들면 402 · 429). 그러니 첫 줄을 그냥 고르지 마세요(앱이 목록을 다시 정렬할 수도 있어요 · 앱 동작). jev 는 질문을 다른 회사가 먼저 읽고 어느 모델로 보낼지 골라요 — 학교에선 모델을 직접 고르세요. 가벼운 모델로 시작하시고 결과가 아쉬울 때만 무거운 모델로 바꾸세요. 같은 질문이라도 모델에 따라 비용이 수십 배 차이 나요(값 예는 아래 「한도에 닿으면」). /v1/models 의 pricing.input_credits_per_mtok · output_credits_per_mtok(100만 토큰당 크레딧 · pricing.rates 의 input_text · output 줄과 같은 값)가 작은 채팅 모델이 가벼운 모델이에요. 모델별 비용은 「모델과 단가」 문서에도 있어요. 10월 기준 가벼운 쪽은 claude-haiku-5-5 · gpt-6-luna · gpt-5-nano 예요. 제미나이 중에선 gemini-3.1-flash-lite 가 가벼워요. 이름에 flash · mini 가 들어 있어도 가볍지 않은 모델이 있으니(예: gemini-3.5-flash) 값으로 고르세요. 앱은 앞 대화를 매번 같이 보내서(앱 동작) 대화가 길어질수록 한 번에 드는 크레딧도 커져요 — 주제가 바뀌면 새 대화로 시작하세요.

그림·PDF 붙이기#

  • 붙인 그림(사진)을 읽고 답하는 건 돼요. Claude 로 보낼 땐 앱이 보낸 그림(image_url · data: 와 https 둘 다)을 Claude 형식으로 옮기고, GPT 는 그대로 넘겨요. 그림을 볼 수 있는 모델을 고르세요. /v1/models 에는 그림을 보는지 알려 주는 칸이 없어요. 글만 받는 모델에 그림을 보내면 모델 회사가 거절해 400 이 와요 — 그땐 다른 모델로 바꾸세요.
  • 그림을 새로 만드는 건 대화로는 안 돼요 — 이름에 image 가 든 그림 모델을 대화에 고르면 400 「… 은(는) 그림 모델이에요. 글 문으로는 부를 수 없어요 — …」가 와요(grok-imagine-video 같은 영상 모델이면 「영상 모델이에요」). 설치 없이 확실한 길은 「팀과 한도」 초대로 들어간 웹 대화(https://schoolorder.kr/ai)의 「🎨 그림」이에요 — 기본 그림 모델이면 입력창 칩에 한 장 값도 보여요. 앱의 그림 만들기 메뉴가 OpenAI 그림 형식으로 https://oneport.kr/v1/images/generations 를 부르면 될 수도 있어요(앱 동작 · 저희가 시험하지 않았어요).
  • 한 번에 보내는 요청 전체가 4.5MB 까지예요. 그림은 글자(base64)로 바뀌어 보내져 원본보다 3분의 4배(약 1.33배)쯤 커져서, 3MB 넘는 사진은 줄여서 붙이세요. 앞 대화도 같이 실려 가니(위 「처음 고를 모델」), 그림을 여러 장 붙인 대화는 새 대화로 시작하세요. 넘으면 영어 오류 413(FUNCTION_PAYLOAD_TOO_LARGE)이 와요.
  • PDF 는 앱이 글자를 뽑아 보내면 어느 모델이든 돼요. PDF 파일 자체를 보내는 앱이면 Claude 로 보낼 땐 저희가 Claude 의 PDF 형식으로 옮기고, GPT 는 그대로 넘겨요. 파일을 먼저 올려 두는 방식(files)의 앱은 404 「파일을 미리 올리는 문(files)은 없어요. …」가 떠요 — 그땐 PDF 글을 복사해 입력창에 붙여 넣으세요.

남은 크레딧 보기#

  • 학교 지갑에 남은 크레딧 — 키 받기 링크는 주문서(학교장터는 입력 링크)에 적은 연락처로만 가요. 대시보드에서 키를 받은 선생님은 아래 터미널(윈도우는 PowerShell) 한 줄로 보세요. 링크를 받으셨으면 받으신 메일 · 문자의 키 받기 링크를 다시 누르면 맨 위 「남은 크레딧」에 보여요. 열린 화면의 주소는 열쇠 부분이 지워져요 — 그 주소(즐겨찾기)로 다시 열면 확인 코드 칸이 나오고, 링크를 받은 메일이나 휴대폰으로 온 코드를 넣으면 열려요. 메일 · 문자 속 링크를 누르면 코드 없이 바로 열려요. 링크에는 기한이 없어요. 다만 키가 꺼졌거나 기한이 지난 화면이면 잔액이 안 보여요. 그땐 지갑 주인 화면에서 보세요. 지갑 주인은 산 곳 대시보드의 AI API 화면(스쿨오더면 https://schoolorder.kr/dashboard/api · 지갑 주인 메일로 로그인)에서 잔액과 키마다 이번 달 사용 · 한도를 봐요.
  • 같은 링크를 다시 누르면 「키 하나 더 받기」가 나와요. 누를 때마다 새 키가 하나 생기고 앞 키는 그대로 써요(링크 하나로 5개까지 · 어느 키로 쓰든 같은 크레딧). 새 키는 바로 앞 키의 한도 · 기한을 그대로 물려받아요 — 첫 키에 한도를 먼저 걸어 두면 나머지도 같은 한도로 받아요. 키 글자는 받은 자리에서 한 번만 보여요.
  • 이 키 한 줄에 남은 몫 — GET https://oneport.kr/v1/key 의 month.remaining_credits(이번 달) · day.remaining_credits(오늘)예요. 한도를 안 건 키면 null 이고 지갑 잔액까지 써요. 키를 머리글(Authorization: Bearer)로 보내야 해서 브라우저 주소창으로는 안 열려요. 맥은 「터미널」, 윈도우는 「PowerShell」을 열고 이 한 줄을 붙여 넣으면 보여요(sk-so-… 자리에 키): curl -s https://oneport.kr/v1/key -H "Authorization: Bearer sk-so-…" — 윈도우 PowerShell 에서는 curl 대신 curl.exe 로 적어요(OS 동작). 다시 열리는 시각은 같은 칸의 resets_at 이에요. 지갑 전체 잔액도 선생님 키로 봐요 — 같은 자리에 curl -s https://oneport.kr/v1/credits -H "Authorization: Bearer sk-so-…" 를 붙여 넣으면 balance_credits 가 나와요. 둘 다 요금이 안 붙어요. 1 크레딧은 2원(부가세 포함)이에요. 같은 /v1/key 결과의 audience 가 "student" 면 학생 키(아래 「학생에게 줄 때」), "teacher" 면 선생님 키, null 이면 쓰임새를 안 나눈 키예요. usable_until 은 이 키를 쓸 수 있는 마지막 날이에요(기한이 없으면 null). 폰에서는 이 한 줄을 붙일 곳이 없어요 — 지갑 주인께 여쭤 보세요(앞 줄의 지갑 주인 화면이에요 · 지갑 주인 본인이면 폰 브라우저로 그 화면을 열면 돼요).

학생에게 줄 때#

선생님 키를 학생에게 주지 마세요. 키를 아는 사람은 어느 앱 · 어느 컴퓨터에서든 그 키 한도와 지갑 잔액까지 써요. 학생에게는 아래 두 길 중 하나로 따로 주세요.

  • 「학생」 키 — 월 150 크레딧 한도가 기본으로 걸려요. 웹 검색 · 웹 페이지 읽기 · 다른 서버의 도구(원격 MCP) · 영상 만들기 · jev · 작업(/v1/tasks)을 부르면 403 student_key_blocked 예요(학생 키의 모델 목록엔 jev · 검색 모델 · 영상 모델이 안 보여요).
  • 「팀과 한도」의 「학생」 초대 — 웹 대화에서 웹 검색 · 영상 만들기 · jev 가 꺼져요. 다만 월 한도는 기본으로 안 걸려서, 그대로 두면 지갑 잔액까지 써요. 그분이 들어온 뒤 「사람마다 한도 · 쓰임새」(대학 지갑은 「이번 달 사용량」)에서 이번 달 한도를 꼭 걸어 주세요.
  • 학생 키와 「팀과 한도」 초대는 보호자 동의 확인을 마친 지갑에서만 돼요. 만 14세 미만 학생이면 보호자(법정대리인) 동의를 먼저 받아 주세요.

한도에 닿으면#

  • 키에 건 한도에 닿으면 앱에 429 key_limit_exceeded 가 떠요 — 「이 키의 오늘 사용 한도에 닿았어요. 한국 시간 내일 0시에 다시 열려요.」 또는 「이 키의 이번 달 남은 한도로는 이 요청을 보낼 수 없어요. max_tokens 를 줄이면 보낼 수 있을 수 있어요(안 적으면 답 하나를 8,192 토큰으로 잡아요). …」예요(max_tokens 는 앱의 최대 토큰 · 답 길이 칸이에요). 하루 한도는 한국 시간 0시에, 월 한도는 매달 1일 한국 시간 0시에 다시 열려요. 429 문장이 「다른 호출이 잡아 둔 몫」 때문이라고 하면 같은 키로 보낸 다른 답이 아직 안 끝난 거예요 — 그 답이 끝나면 풀리니 잠시 뒤 그대로 다시 보내요. Chatbox 는 429 를 2 · 4 · 8 · 16초 간격으로 몇 번 다시 보낸 뒤에 보여 줘서 문장이 뜨기까지 30초쯤 걸릴 수 있어요(앱 동작 · 10월 Chatbox 공개 소스 기준 · 다시 보낸 것도 요금은 안 붙어요).
  • 월 한도는 답 하나를 보내기 전에 그 답이 쓸 최대 몫까지 맞대 봐요. 그래서 남은 몫이 조금 있어도 막힐 수 있어요. 앱이 답 길이(최대 토큰)를 안 정하면 답 하나를 8,192 토큰으로 잡아요 — 앱 설정에서 최대 토큰을 줄이면 지나갈 수 있어요(칸 이름은 앱마다 달라요). 답 하나가 미리 잡는 몫은 대략 (최대 토큰 × output_credits_per_mtok + 보낸 글 바이트 ÷ 3 × input_credits_per_mtok) ÷ 100만이에요(10월 기준 GPT-5.6 이후 모델은 input 대신 pricing.rates 의 cache_write 단가 — 「남은 한도」 장 「최대 몫」) — 최대 토큰 8,192 로 claude-haiku-5-5 는 약 4 크레딧, claude-opus-5-5 는 약 151 크레딧이에요(10-26 단가 · 정본은 GET /v1/models). 남은 몫(GET /v1/key)이 그보다 작으면 최대 토큰을 그만큼 줄이세요. 미리 잡은 몫을 다 사용하는 건 아니에요 — 답이 끝나면 실제로 쓴 토큰만큼만 사용해요. 예를 들어 질문 1,000 토큰 · 답 1,000 토큰이면 claude-haiku-5-5 는 약 0.6 크레딧, claude-sonnet-5-5 는 약 11 크레딧, claude-opus-5-5 는 약 22 크레딧이에요. 하루 한도는 이렇게 미리 잡지 않아요.
  • 한도는 지갑 주인이 대시보드 키 목록의 「한도 수정」에서 올려요. 올리면 바로 풀려요.
  • 키를 잃어버렸거나 수업 화면 · 단톡방에 키가 보였으면 지갑 주인이 대시보드 키 줄의 「새로 받기」를 눌러요. 같은 이름 · 한도로 새 키가 생기고 잃어버린 키는 꺼져요. 이번 달 · 오늘 쓴 몫은 새 키로 이어져요. 앱에는 새 키를 다시 넣어 주세요.
  • 지갑 잔액이 모자라면 402 insufficient_credit 예요. 문장으로 갈라요 — 「이 요청에 필요한 크레딧이 부족해요(최대 …)」면 최대 토큰을 줄이거나 충전해요. 「(최대 …)」 없이 「크레딧이 부족해요.」로 시작하면 잔액이 거의 다 떨어진 거라 줄여도 안 풀리고 충전해야 해요. 문장에 「다른 호출이 잡아 둔 몫」이 있으면 잔액이 모자란 게 아니라 같은 지갑의 다른 호출(다른 선생님 키 포함)이 잠깐 잡아 둔 거예요 — 잠시 뒤 그대로 다시 보내세요. 충전은 지갑 주인이 해요 — 키를 받은 분은 /buy 에서 직접 사지 말고 키를 준 분(지갑 주인)께 충전을 부탁하세요(402 문장 끝도 그렇게 말해요). 다른 메일로 사면 학교 지갑이 아니라 그 메일의 지갑에 들어가요. 402 · 429 는 부르기 전에 나서 요금이 안 붙어요.
  • 429 rate_limit_error 는 저희 한도가 아니라 모델 회사가 잠깐 몰린 거예요. 조금 뒤 다시 보내세요.
  • 스트리밍을 끈 앱은 답이 다 만들어질 때까지 기다려서, 모델 회사로 보낸 뒤 첫 응답이 120초를 넘으면 422 upstream_execution_unconfirmed 가 와요. 실행 불명이니 같은 요청을 자동으로 다시 보내지 마세요. 이후 새 과제는 앱 설정에서 스트리밍을 켜세요(답이 한 글자씩 흘러나오게 하는 설정이에요 · 칸 이름은 앱마다 달라요). 스트리밍이어도 12분 50초쯤에서 끊기고, 그때까지 나온 답은 사용한 걸로 쳐요.