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

인증

키 발급과 두 가지 헤더 방식.

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

키는 크레딧을 산 곳 대시보드의 AI API 화면(스쿨오더 https://schoolorder.kr/dashboard/api · 오피스오더 https://officeorder.co.kr/dashboard/api — 크레딧을 산 계정으로 로그인해요)에서 만들어요. 만든 키는 그 자리에서 한 번만 보여요 — 저장해두지 않기 때문에 잃어버리면 키 목록 그 줄의 「새로 받기」로 같은 설정의 새 키를 받아요(옛 키는 꺼져요). 키 받기 링크로 받으셨다면 같은 링크에서 하나 더 받으실 수 있어요(링크 하나로 5개까지). 그래서 키 받기 링크 메일도 키처럼 지켜 주세요 — 링크에는 기한이 없어서, 그 링크를 가진 누구든 언제든 키를 받을 수 있어요. 링크로 받은 키를 모두 폐기하면 링크도 막혀요. 링크 메일까지 샜다면 「새로 받기」 말고 「폐기」로 그 링크로 받은 키를 모두 끄세요 — 「새로 받기」로 받은 새 키도 그 링크의 키로 남아서 링크가 계속 열려요. 계속 쓸 키는 「새 키 발급」의 「키 만들기」로 따로 만들어요.

두 가지 헤더를 다 받아요#

OpenAI SDK 는 Authorization: Bearer 를, Anthropic SDK 는 x-api-key 를 써요. Claude Code 는 키를 ANTHROPIC_AUTH_TOKEN 으로 넣으면 Bearer 로 보내요. 둘 다 받으니 헤더를 손볼 필요가 없어요. 모든 /v1 문이 둘 다 받아요(/v1/credits · /v1/key · /v1/keys 포함). 둘이 같이 실리면 x-api-key 를 읽고 Authorization 은 안 봐요 — 예전 Anthropic 키(ANTHROPIC_API_KEY)나 프록시가 붙인 x-api-key 가 남아 있으면 Bearer 에 맞는 키를 실어도 401 이에요. Authorization 은 「Bearer 」 뒤에 키를 적어야 읽혀요.

bash
# OpenAI 스타일
Authorization: Bearer sk-so-...

# Anthropic 스타일
x-api-key: sk-so-...
  • 키는 sk-so-(관리 키는 sk-som-) 뒤에 영문 · 숫자 · - · _ 32글자예요. 커밋 전 · CI 의 비밀 검사는 이 꼴로 걸면 돼요. 공개 저장소에 올라가도 저절로 꺼지지 않으니(깃허브 비밀 검사가 이 꼴을 몰라요 · 10월 기준) 직접 폐기하세요.
  • 샌 키가 목록의 어느 줄인지는 키 앞부분으로 찾아요. 줄마다 sk-so- 와 그 뒤 6글자에 … 이 붙어 보여요(sk-so-abc123…). 같은 꼴(끝의 … 까지)이 그 키로 부른 GET /v1/key · /v1/credits 의 key_prefix 로도 와요(요금 없음) — 샌 키의 앞 12글자와 견줄 땐 … 을 떼고 보세요.
  • 얼마나 쓰였는지는 키 목록 그 줄의 「이번 달 사용 / 한도」에서 봐요. 「새로 받기」 뒤엔 새 키 줄에서 보고, 「폐기」하면 그 줄이 목록에서 빠져요.
  • 「사용 기록」의 「키별 사용량」(회사 · 대학 지갑 — 오피스오더에서 회사 · 기관으로 주문해 연 지갑도 회사 지갑이에요)은 켜진 키만 고를 수 있고 최근 30건만 보여요. 끈 키의 호출은 「사용 기록」 아래 「정산 원장 받기 (CSV)」에 그 키 앞부분 · 이름과 함께 남아요(학교 지갑은 줄이 한데 모일 수 있어요 — 「크레딧」 장). 정산 원장은 한 줄이 키 × 날짜 × 모델이라 호출 시각 · IP 는 없어요 — 샌 키는 날짜 · 모델 · 쓴 몫으로 봐요.

키 관리#

  • 키 만들기 · 폐기 · 새로 받기 · 한도 수정 · 정산 원장 받기는 지갑 주인 계정으로만 돼요(함께 쓰는 분이 누르면 「지갑 주인만 할 수 있어요.」).
  • 한 지갑에 활성 키를 기본 50개까지 둘 수 있어요(구성원의 채팅 키도 이 50개에 들어가요). 구성원은 「함께 쓰는 사람」으로 초대한 분이에요 — 웹 대화를 아직 안 여셨어도 한 자리를 잡아 둬요. 기한이 지났지만 폐기하지 않은 키도 한 자리를 써요(키 목록의 「기한 지난 키 폐기」로 돌려받아요). 더 필요하면 계약에 맞춰 올려 드려요. 용도별로 나눠 쓰면 하나가 새도 그것만 끊으면 돼요.
  • 폐기한 키는 즉시 막혀요 — 다음 요청부터라, 이미 받고 있던 답(스트림 포함)은 끝까지 가고 쓴 만큼 사용돼요(「새로 받기」로 꺼진 옛 키도 같아요). 그 키로 이미 만들기 시작한 영상(/v1/videos)도 키를 꺼도 끝까지 만들어지고 정산돼요. 글 문(/v1/chat/completions · /v1/messages · /v1/responses)의 Idempotency-Key 접수와 상태 조회(x-gateway-status-url)는 그 요청을 보낸 API 키에 묶여요. 키 목록의 「새로 받기」(스페이스 강좌 키 · 개인 API 키도 같아요)로 바꾸면 접수가 새 API 키로 옮겨 가요 — 옛 API 키로 받은 조회 주소를 새 API 키로 GET 하면 읽히고, 같은 Idempotency-Key 를 새 API 키로 보내도 같은 접수로 묶여요. 옛 API 키로 부르면 401 이에요. 이 401 은 접수 전 거절이라 조회 주소가 없어요 — 「새로 받기」로 받은 새 API 키로 같은 Idempotency-Key · 같은 본문을 보내면 돼요. 앞 접수가 처리 중이거나 실행됐으면 409 request_already_exists 와 조회 주소가 오고, 없었거나 실행 전에 막혀 끝났으면(not_started) 새로 실행돼요.
  • 「새로 받기」를 누르는 순간 그 키로 Idempotency-Key 를 실어 처리 중이던 요청도 끝이 적혀요. 모델 회사로 보낸 요청은 새 API 키로 조회하면 결과(result)와 정산(settlement)이 읽혀요. 실행 전에 막힌 요청(402 held_by_others · 429 등)은 풀려서, 같은 Idempotency-Key 를 새 API 키로 보내면 새로 실행돼요. 접수만 되고 아직 모델 회사로 보내기 전이었던 요청은 실행되지 않아요 — 조회는 execution not_started · result.state failed · settlement.state not_charged 이고, 같은 Idempotency-Key 를 새 API 키로 다시 보내면 새로 실행돼요. 그 키로 아직 끝나지 않은 호출이 잡아 둔 몫과 만드는 중인 영상도 새 API 키로 옮겨 가서, 새 API 키의 이번 달 한도(month.held_credits)에 잡혀요.
  • 안 샌 키를 「새로 받기」로 바꾸면 옛 API 키가 바로 꺼져서, 그 키를 쓰던 서비스는 새 API 키를 넣을 때까지 끊겨요. 끊기지 않게 바꾸는 길은 따로 만든 키예요. 다만 작업(/v1/tasks)을 맡겨 둔 키면, 따로 만든 키로 바꾸기 전에 작업이 끝났는지 보세요 — 옛 API 키를 폐기하거나 기한이 끝나면 열린 작업은 멈추고, 따로 만든 키로는 그 작업을 못 읽어요(404). 작업을 이어 가려면 「새로 받기」로 바꾸세요. 「폐기」만 하거나 「새 키 발급」 · 관리 키로 따로 만든 키로 바꾸면 접수는 안 옮겨 가요 — 옛 API 키로 받은 조회 주소는 옛 API 키로 부르면 401, 새 API 키로 부르면 404 「요청을 찾을 수 없어요」이고, 같은 Idempotency-Key 를 새 API 키로 보내면 앞 접수와 이어지지 않아 새 요청으로 실행돼요. 그래서 폐기하기 전에 결과를 모르는 접수(422 upstream_execution_unconfirmed · 409 request_already_exists)를 먼저 조회해 두세요. 이미 폐기했는데 결과를 모르는 접수가 있으면, 다시 보내기 전에 그 요청의 요청 ID 와 부른 시각을 admin@schoolorder.kr 로 알려 주세요.
  • 작업(/v1/tasks)도 「새로 받기」를 따라 새 API 키로 옮겨 가요 — 조회 · 이벤트 · 취소 · 파일 받기 · 같은 Idempotency-Key 가 새 API 키로 열리고, 키마다 3건 상한과 정산도 새 API 키에서 이어져요. 스페이스 개인 키를 다른 강좌의 키로 새로 받으면 그 작업은 옮겨 가지 않아요. 폐기했거나 기한이 끝난 키(옮겨 가지 못한 작업의 옛 API 키도)로 맡긴 열린 작업은 5분마다 도는 정리 때 멈추고, 쓴 만큼만 정산돼요. 영상(/v1/videos)은 같은 지갑의 새 API 키로도 읽혀요(학생 키로는 영상을 만들 수도, 다른 키의 영상을 볼 수도 없어요).
  • 키가 샜다면 조회해 둘 틈 없이 끄는 게 먼저예요 — 「새로 받기」로 끄면 접수도 새 API 키로 이어져서 끈 뒤에 조회하면 돼요(「폐기」로 껐다면 위처럼 문의해 주세요). 샌 키로 남이 작업을 맡겼을 수 있으면 「폐기」로 끄세요 — 폐기한 키의 열린 작업은 정리 때 멈추지만, 「새로 받기」는 작업도 새 API 키로 옮겨서 계속 돌아요(작업 목록 문이 없어 모르는 작업 id 는 멈출 수 없어요).
  • 대시보드의 「새로 받기」는 같은 이름 · 한도 · 기한 · 쓰임새로 새 키를 만들고 옛 키를 바로 꺼요. 이번 달 · 오늘 쓴 몫은 새 키로 이어져서 한도가 다시 차지 않아요 — 샌 키로 남이 한도를 다 썼으면 새 키도 바로 429 key_limit_exceeded 예요. 기한이 지난 키는 새로 받을 수 없어요 — 「한도 수정」에서 기한을 오늘이나 그 뒤로 늘리면 같은 키가 다음 요청부터 다시 열려요(바꿔 넣을 필요 없어요 · 기한이 지난 사이 멈춘 작업은 다시 돌지 않아요). 키를 따로 만들려면 「새 키 발급」의 「키 만들기」로 만들어 바꿔 넣고, 위 줄대로 결과를 모르는 접수와 맡긴 작업을 확인한 다음 옛 API 키를 폐기하세요. 샌 키는 이 순서로 하지 말고 「새로 받기」나 「폐기」로 바로 끄세요 — 바꿔 넣는 동안 샌 키가 살아 있어요. 따로 만든 키는 이름(초·중·고 학교 지갑은 쓰임새도)만 받아서 한도 · 기한을 다시 걸어야 해요. 바꿀 시간을 두고 끄려면 옛 API 키에 「이 날까지 사용」을 거세요 — 그 날이 지나면 폐기와 같아서, 그 키로 맡긴 열린 작업도 멈춰요. 키를 여러 개 바꿀 땐 새 키 카드의 「보관했어요」를 누른 다음 줄의 「새로 받기」를 눌러요 — 그 전엔 「새로 받기」가 안 눌려요(「폐기」는 눌려요).
  • 키마다 「이 날까지 사용」을 정하면 그다음 날 한국 시간 0시에 저절로 닫혀요(401). 학기 마지막 날을 고르시면 돼요.
  • 크레딧은 계정 단위예요 — 키를 새로 만들어도 잔액은 그대로예요.
  • 키를 스크립트로 만들고 · 고치고 · 끄려면 관리 키(sk-som-…)로 /v1/keys 를 부르세요. 관리 키는 대시보드 AI API 화면의 「API 키」 아래 「관리 키」에서 지갑 주인이 만들어요. 관리 키로 모델 문을 부르면 401 이고, 거꾸로 sk-so- 키로 /v1/keys 를 불러도 401 이에요. POST /v1/keys 본문에 name · monthly_limit_credits · daily_limit_credits · expires_on(마지막으로 쓸 날 · YYYY-MM-DD)을 같이 넣으면 한도 · 기한까지 한 번에 걸려요. 만들기 · 고치기 · 끄기(POST · PATCH · DELETE)의 칸 전부는 「키 관리」 장(https://oneport.kr/docs/reference/keys.md)에 있어요. /v1/keys 엔 「새로 받기」가 없어요 — 관리 키로 만들어 바꾸고 끄면 따로 만든 키와 같아서, 결과를 모르는 접수와 맡긴 작업이 새 키로 안 옮겨 가요(위 키 바꾸기 줄). 관리 키는 지갑마다 5개까지예요. 만든 분이 지금도 지갑 주인일 때만 열려요(주인이 바뀌면 저절로 꺼져요). 관리 키로는 GET /v1/credits · /v1/key 도 못 불러요(401).
  • 학생 키도 sk-so- 로 시작해요. 학생 키로는 웹 검색 · 웹 페이지 읽기 · 다른 서버의 도구(원격 MCP) · 영상 만들기 · jev · 작업(/v1/tasks)이 막혀서 403 student_key_blocked 가 와요. 같은 강좌 키라도 선생님 키면 열려 있어요. 학생 키로 부른 글 문은 모델로 보내기 전에 이번 요청의 글(시스템 지시와 마지막 user 메시지)을 웹 채팅과 같은 유해 문장 검사로 봐요 — 걸리면 422 school_guard_blocked, 검사를 못 하면 503 school_guard_unavailable 이고 둘 다 요금이 안 붙어요.
  • 키가 안 열리면 401 authentication_error 예요 — 이유는 error.reason 으로 갈라요(아래 「키가 안 열릴 때」 표). 두 머리글이 같이 오면 x-api-key 를 먼저 읽어요 — 두 값이 다르면 reason 이 무엇이든 401 message 끝에 「x-api-key 머리글의 키를 읽었어요」가 붙어요. Bearer 에 새 키를 실었는데 이 말과 함께 key_revoked · key_expired · key_not_found 가 오면 x-api-key 에 남은 옛 키가 읽힌 거예요 — x-api-key 머리글부터 지우세요. 401 은 다시 보내도 같아요 — 코드는 멈춰서 키를 고치게 하세요. 키를 잠깐 못 읽었으면 401 이 아니라 503 api_error(「지금 이 키를 확인하지 못했어요」 · reason 도 이 꼬리도 없음)예요 — 문에 따라 Retry-After 가 없으니 2초쯤 쉬고 같은 요청(Idempotency-Key 를 실었으면 같은 키 · 같은 본문)을 한 번 다시 보내요.

키가 안 열릴 때#

401 authentication_error 엔 error.reason 이 와요(2026-10-30 부터 · OpenAI · Anthropic 형식 모두 error 안). Python openai SDK 는 e.body.get("reason"), Node openai SDK 는 err.error.reason 으로 읽어요(Anthropic SDK 는 Python e.body["error"].get("reason") · Node err.error.error.reason). 관리 키 문 /v1/keys 의 401 은 값이 둘뿐이에요 — missing_key(관리 키를 못 읽음) · malformed_key(sk-som- 관리 키가 아님 · sk-so- 키를 보냈을 때도)이고, 없거나 꺼졌거나 기한이 지난 관리 키의 401 엔 reason 이 없어요(「키 관리」 장). reason 이 없거나 아래에 없는 값이면 message 를 사람에게 그대로 보여 주세요 — 문장은 사람에게 보일 안내라 바뀔 수 있어서 코드로 가르지 마세요.

error.reason뜻할 일
missing_key키를 못 읽었어요 — Authorization · x-api-key 머리글이 없거나 비었거나, Authorization 에 「Bearer 」가 빠졌어요(빈 환경변수도 이거예요).머리글을 Authorization: Bearer sk-so-… 나 x-api-key: sk-so-… 로 고쳐요.
malformed_keysk-so- 로 시작하지 않아요 — 키 앞에 따옴표나 「Bearer 」가 같이 들어갔거나 앞이 잘렸어요(뒤에만 따옴표 · 글자가 붙었거나 뒤가 잘린 sk-so- 키는 key_not_found 예요 · 앞뒤 공백은 저희가 지워요).따옴표 · 「Bearer 」 없이 키만, 처음부터 끝까지 다시 복사해 넣어요.
unset_key키 자리에 null · undefined · None 글자가 왔어요 — 환경변수 · 스크립트 속성이 비어 있는데 그 값을 그대로 붙였어요(문장은 「키 값이 비어 있어요(…)」로 시작해요 · 괄호 안은 온 글자 · 2026-10-31 부터).변수 · 속성 이름이 맞는지 보고 키를 넣어요 — 「Bearer 」는 지우지 마세요.
foreign_keysk- · AIza · xai- 로 시작하는 다른 키예요(sk-ant- · sk-proj- · AIza… 등 — message 에 어떤 키로 보이는지가 와요 · 이름을 말하지 않는 것도 있어요). sk-so- 를 잘못 친 sk- 글자도 이 값이에요.원포트·스쿨오더에서 받은 sk-so- 키로 바꿔요 — 잘못 친 거면 다시 복사해 넣어요.
management_key관리 키(sk-som-)로 불렀어요 — 관리 키는 /v1/keys 전용이에요.같은 지갑의 sk-so- 키로 불러요.
key_not_foundsk-so- 꼴이지만 없는 키예요 — 글자가 빠지거나 바뀌었을 수 있어요.받은 키를 다시 복사해 넣어요. 그래도 같으면 키 목록에서 그 키가 있는지 봐요.
key_revoked꺼진 키예요(「폐기」 · 「새로 받기」로 꺼짐 · 꺼졌으면서 기한도 지난 키 포함).지금 쓰는 키로 바꿔요 — 키 목록에서 확인하거나 지갑 주인에게 새 키를 받아요.
key_expired「이 날까지 사용」이 지났어요.지갑 주인이 「한도 수정」에서 기한을 늘려요(위 「키 관리」의 「새로 받기」 줄).
account_inactive이 키의 지갑이 멈췄어요.키를 고칠 일이 아니에요 — admin@schoolorder.kr 로 알려 주세요(키를 다시 받아도 안 풀려요 · 스페이스 키면 아래처럼 스페이스 관리자에게).

스페이스 키(학생 · 그룹 키)면 key_revoked · key_expired · account_inactive 의 할 일은 스페이스 관리자(선생님)에게 말하는 거예요.

환경변수로 두는 법#

키를 코드에 적지 마시고 환경변수로 두세요. 도구마다 읽는 이름이 달라요. Codex CLI 는 환경변수 주소를 안 읽어서 ~/.codex/config.toml 에 따로 적어요 — 「Codex CLI」 장을 보세요. Cursor · Cline 처럼 화면에 주소를 넣는 도구는 Base URL 칸에 https://oneport.kr/v1, API Key 칸에 sk-so- 키를 넣어요 — 「Cursor · Cline · 그 밖의 도구」 장(https://oneport.kr/docs/guides/cursor-cline.md). Claude Code 는 「Claude Code」 장(https://oneport.kr/docs/guides/claude-code.md)에 Windows(settings.json)와 ANTHROPIC_API_KEY 지우는 법까지 있어요.

~/.zshrc 나 ~/.bashrc 에
# OpenAI SDK (Python · Node 가 읽어요)
export OPENAI_BASE_URL="https://oneport.kr/v1"
export OPENAI_API_KEY="sk-so-..."

# Anthropic SDK · Claude Code  (⚠️ 여기는 /v1 을 붙이지 않아요)
export ANTHROPIC_BASE_URL="https://oneport.kr"
export ANTHROPIC_AUTH_TOKEN="sk-so-..."

잘 붙었는지 확인하기#

키가 살아 있는지, 잔액이 얼마인지 한 줄로 볼 수 있어요. 이 문은 모델을 안 부르니 요금이 안 붙어요.

요금 없이 키 확인
export ONEPORT_API_KEY="sk-so-..."
curl https://oneport.kr/v1/credits \
  -H "Authorization: Bearer $ONEPORT_API_KEY"

-H "x-api-key: $ONEPORT_API_KEY" 로 보내도 같아요. 연결 확인엔 GET /v1/models 도 써요 — 키 머리글을 실었는데 키를 못 읽으면(「Bearer 」 빠짐 · 빈 값) 다른 문처럼 401 missing_key 이고, 틀린 키 · 꺼진 키도 401 이에요. 두 머리글이 다 없을 때만 키 없는 전체 목록이 200 으로 와요. 이 키의 한도 · 기한은 같은 머리글로 GET https://oneport.kr/v1/key 를 부르면 와요 — month · day 의 used_credits · limit_credits · remaining_credits · resets_at, usable_until(마지막으로 쓸 수 있는 날), audience 예요(요금 없음). /v1/credits · /v1/key 가 실패하면 몸통은 {"error": {"type", "message", "code", "reason", "request_id"}} 꼴이에요(reason 은 401 일 때만 — 값은 위 표) — 키를 잠깐 못 읽었으면 503 api_error 라 잠시 뒤 다시 보내요.

Postman · curl 처럼 주소를 통째로 적을 땐 OpenAI 형식은 POST https://oneport.kr/v1/chat/completions, Anthropic 형식은 POST https://oneport.kr/v1/messages 예요(본문은 JSON — Content-Type 은 저희가 안 봐요). Postman 의 Authorization 탭에서 Bearer Token 을 고르면 칸엔 키만 넣어요 — 「Bearer sk-so-…」를 넣으면 Bearer 가 두 번 나가 401 malformed_key 예요. 환경을 안 골라 {{ONEPORT_API_KEY}} 글자가 그대로 나가도 malformed_key, 변수 값이 비면 missing_key 예요(Postman 동작).

사람마다 키를 따로 드리세요#

  • 초·중·고 학교 지갑은 새 키의 쓰임새가 「선생님」으로 먼저 골라져 있어요. 학생에게 나눠 줄 키는 「새 키 발급」에서 쓰임새를 「학생」으로 바꾼 뒤 「키 만들기」를 누르세요(관리 키로 만들 땐 "audience": "student" — 안 보내면 선생님이에요). 학생 키는 월 150 크레딧 한도로 만들어지고, 웹 검색 · 웹 페이지 읽기 · 다른 서버의 도구(원격 MCP) · 영상 만들기 · jev · 작업(/v1/tasks)이 403 student_key_blocked 예요(Claude Code 의 웹 검색도 막혀요). 학생 키는 보호자 동의 확인을 마친 지갑에서만 만들어져요. 이미 만든 키는 목록의 쓰임새 칩에서 바로 바꿔요. 월 한도가 학생 기본값(150 크레딧) 그대로인 키를 「선생님」으로 바꾸면 한도도 풀려서 지갑 잔액까지 써요. 한도가 없는 키를 「학생」으로 바꾸면 월 150 크레딧 한도가 들어가요(하루 한도가 그보다 크면 빼고요). 손으로 적은 한도는 쓰임새를 바꿔도 그대로예요. 어느 쪽 키인지는 그 키로 GET /v1/key 를 부르면 audience 칸("student" · "teacher" · 나누지 않은 키는 null)으로 와요.
  • 학생 키로 큰 모델(claude-opus-5-5 등)을 부르면 첫 질문부터 429 key_limit_exceeded(error.reason "key_month_limit")일 수 있어요. 답 길이(max_tokens)를 안 적으면 답 하나를 8,192 토큰으로 미리 잡는데, 그 몫이 월 한도(150 크레딧)보다 크거든요(10월 기준 · 정본은 GET /v1/models). 그 키의 GET /v1/models 엔 이런 글 모델도 남아 있어요 — 월 한도로 빠지는 건 그림 모델뿐이에요(「모델과 단가」 장). 「한도 수정」에서 월 한도를 올리거나, 가벼운 모델 · 짧은 max_tokens 로 부르세요.
  • 키는 여러 개 만드실 수 있고 이름을 붙이실 수 있어요 — 누구 건지 모르면 나중에 한도도 회수도 못 해요.
  • 키마다 이번 달 한도 · 하루 한도 · 「이 날까지 사용」을 거실 수 있어요(한도는 크레딧으로 적어요). 「새 키 발급」은 이름(초·중·고 학교 지갑은 쓰임새도)만 받으니, 만든 뒤 키 목록 그 줄의 「한도 수정」에서 넣으세요. 「여러 개 발급」은 한도를 만들 때 같이 넣고, 이름은 「앞머리 1 · 앞머리 2 …」로 붙어요 — 사람 이름을 붙이려면 「새 키 발급」으로 하나씩 만드세요. 키를 이어서 만들 땐 방금 뜬 새 키 카드의 「보관했어요」를 눌러야 다음 「키 만들기」 · 「일괄 발급」이 눌려요. 하루 한도는 월 한도보다 클 수 없어요. 한도를 안 건 키(선생님 키 · 쓰임새를 나누지 않는 지갑의 키)는 지갑 잔액까지 써요. 한 사람이 한도를 넘겨도 나머지 분들은 그대로 쓰세요. IP · 모델로 키를 묶는 칸은 없어요.
  • 한 키로 동시에 여러 번 부르면 이번 달 한도는 아직 안 끝난 호출 몫까지 더해 재요 — 그래서 넘으면 429 key_limit_exceeded 의 error.reason 이 held_by_others 로 와요. 이건 Retry-After(5초)만큼 기다렸다 그대로 다시 보내면 돼요. 한도를 건 키로 gpt-5.6-sol · gpt-6-sol · gpt-6-luna · gpt-6.1-sol · gpt-6.1-terra · gpt-6-astra · gpt-5.6-terra · gpt-5.6-luna 를 부를 땐 max_tokens(/v1/responses 는 max_output_tokens)를 꼭 적으세요 — 출력 상한 없이 짧은 질문만 보내면 답 하나를 8,192 가 아니라 모델 최대 출력(128,000 토큰)으로 잡아서 첫 호출부터 429 · 402 일 수 있어요(셈은 「남은 한도」 장 https://oneport.kr/docs/reference/key.md).
  • 그만 쓰는 분의 키는 그 키만 폐기하면 돼요. 다른 키와 잔액은 그대로 살아 있어요.
  • 쓴 만큼은 키별로 남아요 — 정산할 때 총액이 아니라 누가 얼마 썼는지가 필요하거든요.