생성형 AI 교육에서 실습 API(프로그램이 AI 모델을 불러 쓰는 연결 통로)를 기관이 관리하려면 세 가지를 교육 전에 정합니다. 키를 누구 명의로 두고 수강생은 어떻게 접속하는지(계정), 어디까지 쓰면 멈추는지(한도), 누가 언제 무엇을 썼는지 무엇을 남기는지(사용 기록)입니다. 이 글은 교육 담당자가 강사·업체와 실습 환경을 정할 때 확인할 내용을 이 세 가지 순서로 정리합니다.

교육 전날 강사가 자기 API 키를 실습 안내 문서에 붙여 넣는 경우가 있습니다. 교육 당일에는 문제없이 돌아갑니다. 그런데 교육이 끝난 뒤에도 그 키는 문서에 남아 있고, 누가 계속 쓰는지 알 수 없으며, 비용은 강사 개인 계정으로 나갑니다.

반대로 수강생마다 AI 서비스에 개인으로 가입하게 하면 교육 초반이 가입과 결제 수단 등록으로 지나가고, 교육 뒤 무엇을 넣었는지는 기관이 볼 수 없습니다. 두 경우 모두 실습 API를 관리할 주인이 정해지지 않았다는 점이 같습니다.

실습 API는 왜 따로 관리하나

API 키는 비밀번호이면서 결제 수단입니다. 키를 가진 사람은 그 계정의 비용으로 AI를 호출할 수 있습니다. OpenAI의 API 운영 문서도 키를 코드나 공개 저장소에 노출하지 말고 안전한 곳에 보관하며, 환경 변수나 비밀 관리 서비스로 프로그램에 넘기라고 안내합니다. 실습 안내 문서, 단체 메신저, 공유 슬라이드에 키를 적는 것은 이 안내와 반대입니다.

교육 실습은 짧은 시간에 여러 사람이 한꺼번에 호출한다는 점도 다릅니다. 한 사람이 같은 요청을 반복하거나 긴 파일을 여러 번 넣으면 예상보다 빨리 비용이 쌓입니다. 그래서 실습 API는 "누가 갖고, 얼마까지 쓰고, 무엇이 남는가"를 미리 정해 둘 대상입니다.

실습 API를 운영하는 세 가지 방식 비교 — 강사 개인 키를 공유하는 방식, 수강생이 각자 가입하는 방식, 기관 계정과 실습 환경을 쓰는 방식을 키 위치·비용·기록·교육 뒤 정리 네 항목으로 나눈 예시 도식

1. 계정 — 키는 기관 명의로, 수강생에게는 키 대신 접속을

첫째는 계정입니다. 실습용 키는 강사 개인이 아니라 기관(또는 기관이 맡긴 운영사) 명의로 두는 편이 정리가 쉽습니다. 그래야 교육이 끝난 뒤 키를 멈추거나 바꾸는 사람이 분명하고, 비용 정산도 기관 안에서 끝납니다.

수강생에게는 키를 나눠 주지 않고 접속만 열어 주는 방식이 안전합니다. 키는 서버 쪽에만 두고, 수강생은 강의 화면이나 실습 페이지에 접속해 쓰는 구조입니다. 오픈컬리지의 AIRO 시스템이 이 방식입니다. 수강생은 짧은 주소와 강의 코드로 강의실에 들어와 강사 승인을 받고, 실습 요청은 서버를 거쳐 실습 AI 환경(Gadia)으로 갑니다. 그래서 수강생은 AI 서비스에 따로 가입하거나 로그인하지 않고, 키를 손에 쥘 일도 없습니다.

계정을 정할 때는 용도도 나눕니다. Anthropic(Claude)은 조직 안에 워크스페이스를 만들어 용도별로 API 자원을 나누게 하고, 키는 만든 워크스페이스에 묶여 다른 곳으로 옮길 수 없다고 안내합니다. 실습용과 업무용 키를 처음부터 나눠 두면, 교육이 끝나 실습용 키를 멈춰도 업무에는 영향이 없습니다.

강사·업체와 정할 것

  • 실습용 키는 누구 명의이고, 교육 뒤 누가 멈추거나 바꾸나
  • 수강생은 키 없이 접속만 하나, 키를 직접 받나
  • 실습용과 업무용 키·계정을 나눠 두나

2. 한도 — 기관·과정·개인 단위로 나눠 정하기

둘째는 한도입니다. 한도는 한 숫자가 아니라 층으로 생각하면 정하기 쉽습니다. 기관 전체 한도 아래에 과정(반) 한도를 두고, 그 아래에 수강생 한 사람의 한도를 둡니다. 위 칸이 아래 칸보다 항상 크거나 같아야 합니다.

Anthropic도 워크스페이스별 지출 한도는 조직 한도보다 낮게만 정할 수 있고, 요청마다 워크스페이스와 조직 한도를 모두 적용한다고 안내합니다.

함께 정할 것은 한도에 닿았을 때의 동작입니다. 요청을 막을지, 더 가벼운 모델로 바꿀지, 알림만 보낼지 미리 고릅니다. OpenAI는 지출 알림과 함께, 월 상한을 강제하려면 한도에 닿을 때 요청을 멈추는 강제 지출 한도(hard spend limit)를 두라고 안내합니다. 교육 중에 한도가 갑자기 막히면 실습이 끊기므로, 막기 전에 담당자에게 먼저 알리는 단계를 두는 편이 좋습니다.

실습 API 한도를 기관 전체·과정(반)·수강생 세 층으로 나누고, 한도에 닿았을 때 막기·가벼운 모델로 바꾸기·알림만 보내기 중 하나를 미리 고르며, 막기 전에 담당자에게 먼저 알린다는 예시 도식

교육 뒤에도 기관이 AI를 계속 쓴다면 이 층 구조를 관리 도구에 그대로 옮길 수 있습니다. 예를 들어 (주)유에이지가 운영하는 AI 통합관리시스템 Gadia AIMS는 계정·부서·기관 단위로 월 예산을 정해 두면 초과 시 미리 고른 동작(차단·하향·알림)이 실행되고, 80%에 닿으면 관리자에게 먼저 알린다고 소개합니다.

강사·업체와 정할 것

  • 기관 전체·과정·수강생 한도를 각각 어떻게 두나
  • 한도에 닿으면 막나, 바꾸나, 알리나
  • 교육 중 한도에 가까워지면 누구에게 먼저 알리나

3. 사용 기록 — 누가, 언제, 어떤 모델로, 어느 과정에서

셋째는 사용 기록입니다. 기록은 비용을 나누는 근거이자, 문제가 생겼을 때 무엇을 입력했는지 확인하는 근거입니다. 최소한 누가(계정), 언제, 어떤 모델로, 어느 과정이나 과제에서 호출했는지가 남아야 과정별 비용과 이용 현황을 나눠 볼 수 있습니다.

호출 기록과 별도로 관리 작업 기록도 남깁니다. 키를 새로 만들거나 멈춘 일, 권한을 바꾼 일, 계정을 회수한 일입니다. Gadia AIMS 기능 소개에는 모든 호출에 기관·계정·과제번호가 붙고, 키 등록·정지·권한 변경 같은 주요 작업이 기록되어 조회하고 리포트로 받을 수 있다고 나와 있습니다.

사용 기록에 남길 칸을 보여 주는 예시 표 — 호출 기록은 계정·시각·모델·과정 또는 과제, 관리 기록은 키 생성·정지, 권한 변경, 계정 회수로 나눈 가상 데이터 도식

기록에서 함께 정할 것은 입력 내용의 범위입니다. 호출 기록에는 수강생이 넣은 내용까지 남을 수 있으므로, 실습 자료 기준을 기록 기준과 같은 자리에서 정합니다. 개인정보나 내부 자료가 기록에 쌓이지 않도록 실습용 자료를 따로 준비하는 식입니다(자료 기준은 「직원 AI 교육, 커리큘럼보다 먼저 정해야 할 4가지」에서 다뤘습니다). 기록을 얼마 동안 둘지는 기관의 보존 규정에 맞춥니다.

강사·업체와 정할 것

  • 호출마다 계정·시각·모델·과정이 남나
  • 키 생성·정지, 권한 변경 기록도 남나
  • 기록은 누가 보고, 얼마 동안 두나

4. 교육이 끝난 뒤 — 닫을지, 이어 쓸지

마지막은 교육 뒤입니다. 실습 환경을 교육 날만 열고 닫을지, 정해진 기간 동안 복습용으로 열어 둘지 먼저 정합니다. 닫는다면 실습용 키를 멈추고, 열어 둔다면 그 기간의 한도와 담당자를 다시 정합니다. AIRO처럼 교육 뒤 복습 공간(프롬프트 라이브러리·자료실·Q&A)이 정해진 이용 기간 동안 열리는 경우에도, 그 기간에 실습 요청을 어느 한도 안에서 받을지는 따로 정해 두는 편이 좋습니다.

교육을 계기로 기관이 AI를 직접 쓰기 시작한다면, 실습용 계정을 그대로 업무에 쓰기보다 업무용 계정과 한도를 새로 정하는 편이 깔끔합니다. 사람이 바뀔 때 계정을 회수해 다른 사람에게 다시 주는 절차, 학기나 회차가 바뀔 때 계정을 한꺼번에 발급·회수하는 절차도 이때 함께 정합니다.

실습 API 관리를 교육 전·교육 중·교육 뒤로 나눈 흐름 — 교육 전에는 키 명의·한도·기록 기준을 정하고, 교육 중에는 수강생이 키 없이 접속해 한도 안에서 쓰며, 교육 뒤에는 실습용 키를 멈추거나 복습 기간·한도를 다시 정하고, 업무용 계정과 회수·재배정 절차를 따로 정한다는 예시 도식

교육 담당자 점검표

강사나 업체와 실습 환경을 협의할 때 아래 여덟 가지를 물어보면 대부분 정리됩니다. 답이 비어 있는 칸이 교육 뒤에 관리 공백으로 남기 쉽습니다. 외부 업체를 고를 때 함께 볼 항목은 「직원 AI 교육, 외부에 맡기기 전 확인할 7가지」에, 교육 전체를 기획하는 순서는 「직원 AI 교육, 커리큘럼보다 먼저 정해야 할 4가지」에 정리했습니다.

교육 담당자 점검표 여덟 가지 — 키 명의, 수강생 접속 방식, 실습용·업무용 분리, 층별 한도, 한도 도달 시 동작, 호출 기록, 관리 작업 기록, 교육 뒤 정리를 계정·한도·기록·교육 뒤 네 묶음으로 나눈 도식

정리하면

실습 API 관리는 어려운 기술 문제라기보다 주인을 정하는 일입니다. 키는 기관 명의로 두고 수강생에게는 접속만 열고, 한도는 기관·과정·개인 단위로 나눠 닿았을 때의 동작까지 정하고, 사용 기록은 무엇을 남기고 누가 볼지 정합니다. 이 세 가지를 교육 전에 정해 두면 실습은 끊기지 않고, 교육 뒤에도 비용과 기록이 기관 안에 남습니다.

자주 묻는 질문

Q. 강사 개인 API 키로 실습하면 안 되나요?

A. 당일 실습은 돌아가지만, 교육 뒤 키를 누가 멈추는지, 누가 계속 쓰는지, 비용을 어떻게 정산하는지가 남습니다. 실습용 키는 기관이나 기관이 맡긴 운영사 명의로 두고, 수강생에게는 키 대신 접속만 열어 주는 편이 정리가 쉽습니다.

Q. 수강생 한 사람의 한도는 어떻게 정하나요?

A. 과정 한도를 먼저 정하고, 그 안에서 실습 과제 수와 시간에 맞춰 나눕니다. 처음에는 넉넉하지 않게 시작해 실제 사용량을 보고 조정하고, 한도에 닿기 전에 담당자에게 알림이 가도록 해 두면 실습이 갑자기 끊기는 일을 줄일 수 있습니다.

Q. 사용 기록에는 무엇이 남아야 하나요?

A. 호출마다 계정, 시각, 모델, 과정이나 과제가 남아야 비용과 이용 현황을 나눠 볼 수 있습니다. 키 생성·정지, 권한 변경, 계정 회수 같은 관리 작업 기록도 따로 남겨 두세요.


AI 교육의 실습 환경까지 함께 준비하고 싶다면 교육 문의로 교육 대상과 인원, 희망 시기를 알려 주세요. 수강생이 따로 가입하거나 키를 받지 않고 실습하는 방식은 AIRO 시스템에서, 교육 뒤 기관의 AI 계정·한도·사용 기록 관리는 Gadia AIMS에서 먼저 보실 수 있습니다.