작성자 노트: OpenAI, Claude, Gemini, Qwen을 동시에 연결하는 팀은 하나의 계정에서 프로젝트별로 토큰을 분리하고, 각 토큰에 할당량, 유효 기간, 모델 허용 목록, 그룹을 설정할 수 있으며, 토큰 로그에서 비용을 대조할 수 있어요.
여러 모델을 동시에 연결하는 개발 책임자는 흔히 세 가지 문제를 겪어요. 첫째, 키가 각 벤더의 백엔드에 흩어져 있어 누가 어떤 키를 갖고 있는지 명확히 하기 어려워요. 둘째, 월말 청구서와 프로젝트가 맞지 않아 어떤 프로젝트가 얼마나 썼는지 알 수 없어요. 셋째, 키 하나를 여러 사람이 함께 쓰기 시작하면 특정 한 사람만 따로 중단할 수 없고 키 전체를 무효화해야 해요. 이 글에서는 하나의 APIYI 계정 + 프로젝트별 토큰 분리 관리 방식을 소개하고, 기업 멀티모델 관리를 실제로 실행 가능한 설정 단계로 정리해 볼게요.
이건 또 한 편의 「왜 중계 서비스가 필요한가」를 설명하는 입문 글이 아니에요. 아래의 모든 설정 항목은 APIYI apiyi.com 문서에 있는 토큰 및 그룹 설명에 대응해요. 속도(rate)나 그룹과 관련된 숫자는 모두 문서 원문에서 온 숫자임을 밝힐게요.
핵심 가치: 이 글을 끝까지 읽으면 프로젝트마다 독립 토큰을 하나씩 만들고, 그 토큰이 얼마를 쓸 수 있는지, 얼마 동안 유효한지, 어떤 모델을 호출할 수 있는지, 어떤 그룹으로 라우팅할지를 제한할 수 있어요. 그리고 토큰 로그에서 프로젝트별 소비량을 확인할 수 있습니다.

기업 멀티모델 관리 핵심 포인트: 키, 한도, 로그를 프로젝트별로 분리하기
기업 멀티모델 관리의 핵심은 관리 경계를 나누는 데 있어요. 하나의 만능 열쇠로 다 합치는 게 아니라요. APIYI에서 토큰은 곧 API 키이고, sk-로 시작해요. 문서에 따르면 각 토큰은 한도, 만료 시간, 사용 가능한 모델, 그룹을 개별로 설정할 수 있고, 소비량, 잔여 한도, 호출 로그도 따로 기록돼요.
| 포인트 | 설명 | 개발 책임자에게 주는 가치 |
|---|---|---|
| 프로젝트별 토큰 생성 | 가입하면 기본 토큰이 하나 주어지고, 다른 프로젝트나 다른 멤버를 위해 각각 하나씩 추가로 만들 수 있어요 | 특정 개인이나 프로젝트를 중지해도 다른 호출자에게 영향을 주지 않아요 |
| 한도와 유효 기간 개별 설정 | 토큰마다 한도 상한과 만료 시간을 설정할 수 있어요 | 예산 초과와 외주 계약 만료, 이 두 가지 문제를 미리 제한할 수 있어요 |
| 모델 화이트리스트 | 화이트리스트를 설정하지 않으면 전체 사이트의 200+ 엄선 모델을 사용할 수 있고(문서 원문), 설정하면 지정된 모델만 쓸 수 있어요 | 프로젝트가 임의로 고가 모델로 전환하는 것을 막을 수 있어요 |
| 그룹이 채널과 배수를 결정 | 그룹이 업스트림, 사용 가능한 모델, 과금 배수를 결정해요 | 같은 모델이라도 그룹이 다르면 실제 청구서가 달라질 수 있어요 |
| 로그는 토큰별로 분리 | 토큰마다 소비량과 호출 로그를 따로 확인해요 | 월말 정산 때 바로 프로젝트 단위로 대조할 수 있어요 |
기업 멀티모델 관리에서 토큰을 프로젝트별로 나누는 이유
문서에서 먼저 짚고 넘어가야 할 점이 하나 있어요. 하나의 토큰을 여러 명이 함께 쓸 때 속도 제한은 계정을 기준으로 적용되지, 토큰 개수를 기준으로 하지 않아요. 문서 원문에는 단일 계정 기준 일반적으로 100 RPM 이내는 문제없고, TPM은 따로 평가하지 않는다고 되어 있어요. 이는 문서에 적힌 내용일 뿐, 부하 테스트 결과가 아니며 SLA를 구성하지도 않아요.
그래서 토큰을 나누는 목적은 속도 제한을 우회하는 게 아니라 관리 격리를 하기 위해서예요. 토큰 하나가 프로젝트 하나 또는 멤버 한 명에 대응하면, 문제가 생겼을 때 그 토큰만 중지할 수 있고, 정산할 때 그 토큰만 보면 돼요. 모든 사람이 기본 토큰을 함께 쓰면 로그의 소비량이 뒤섞여서 프로젝트별로 나눌 수 없고, 특정 호출자만 정확히 멈출 수도 없어요.
기업 멀티모델 관리에서 그룹과 폴백 규칙
그룹은 리소스 채널이에요. 문서 원문에 따르면 토큰 하나에 기본 그룹 1개와 폴백 그룹 2개까지 설정할 수 있어요. 폴백의 의미는 기본 그룹이 요청을 처리할 수 없을 때 시스템이 자동으로 폴백 그룹으로 전환한다는 거예요. 문서에서 폴백에 대한 설명은 ‘호출 성공률을 높인다’는 것이지 가용성 보장이 아니에요. 그러니까 ‘절대 실패하지 않는다’고 이해하면 안 돼요.
대부분의 텍스트 모델은 Default 그룹을 사용하면 돼요. 비디오 같은 전용 모델은 다른 그룹을 선택해야 하고, 토큰에 이 그룹이 없으면 해당 모델은 호출할 수 없어요. 또한 ‘200+ 모델’은 전체 사이트의 엄선 모델 총수를 가리키는 것이지, 모든 모델이 Default 그룹에 있다는 뜻이 아니에요. 구체적으로는 각 모델 페이지에 표시된 그룹을 기준으로 해요.

기업용 멀티 모델 관리 빠르게 시작하기: 프로젝트별 토큰 생성 5단계
아래에서는 세 개 프로젝트를 운영하는 팀을 예로 들어 보겠습니다. 검색 강화 프로젝트, 고객 지원 챗봇, 내부 글쓰기 도구를 기준으로 전체 구성 흐름을 보여드릴게요. 시작 지점은 토큰 페이지 https://api.apiyi.com/token입니다.
1단계: 토큰 계획하기 — 프로젝트 하나 또는 사람 한 명당 하나씩
먼저 토큰 계획표를 만들고 나서 관리 콘솔에서 생성하세요. 이렇게 하면 만들다가 계속 고치면서 결국 다시 “하나의 열쇠를 모두가 함께 사용하는” 상태로 돌아가는 일을 피할 수 있어요.
| 토큰 이름 | 사용 주체 | 모델 화이트리스트 | 기본 그룹 | 폴백 그룹 | 할당량 및 유효 기간 권장 사항 |
|---|---|---|---|---|---|
proj-search |
검색 강화 서비스 | gemini-3.8-flash, qwen3.8-max |
Default |
모델 페이지에서 선택 가능한 그룹 설정에 따름 | 월 예산 기준으로 할당량 설정, 장기 유효 |
proj-support |
고객 지원 챗봇 | claude-sonnet-5-5 |
Default |
모델 페이지에서 선택 가능한 그룹 설정에 따름 | 월 예산 기준으로 할당량 설정 |
team-writing-zhang |
멤버 개인 도구 | claude-opus-5-5 |
Default |
설정 안 함 | 작은 할당량, 만료 시간 설정 |
vendor-outsource |
외주 팀 | 전달에 필요한 모델만 포함 | Default |
설정 안 함 | 할당량과 계약 주기를 맞추고, 만료 시 자동으로 사용 중지 |
표의 관리 제안은 저희의 판단입니다. 각 모델이 실제로 어떤 그룹에 속하는지는 해당 모델 페이지를 기준으로 확인하고, 이 표를 그대로 복사하지 마세요.
두 번째 단계: 토큰 생성 및 네 가지 제한 설정
토큰 페이지에서 새 토큰을 만들 때 다음 네 가지 항목을 순서대로 입력해요.
- 할당량: 프로젝트의 월 예산에 맞춰 입력해요. 할당량을 모두 쓰면 해당 토큰은 과금을 멈추고, 다른 토큰에는 영향을 주지 않아요.
- 만료 시간: 외주 인력과 임시 멤버에게는 반드시 설정하세요. 만료되면 수동으로 회수할 필요가 없어요.
- 사용 가능 모델(화이트리스트): 프로젝트에 정말 필요한 모델만 체크하세요. 비워 두면 사이트 전체 모델이 개방되는 것과 같으니 권장하지 않아요.
- 그룹: 먼저 기본 그룹을 선택한 뒤 필요에 따라 최대 2개의 예비 그룹을 추가하세요.
세 번째 단계: 키를 환경 변수에 넣고 프로젝트별로 변수 이름 구분하기
키를 코드나 저장소에 하드코딩하지 마세요. 각 프로젝트가 독립된 환경 변수 이름을 사용하는 것을 권장해요. 예를 들어 배포 환경에서 APIYI_KEY_SEARCH=sk-..., APIYI_KEY_SUPPORT=sk-...를 설정하고, 각 서비스가 해당 값을 읽게 하면 돼요. 이렇게 하면 특정 프로젝트의 키를 교체할 때 변수 하나만 바꾸면 돼요.
4단계: OpenAI 호환 인터페이스로 호출하기
APIYI는 OpenAI 호환 인터페이스를 제공하므로, 연동할 때 두 곳만 바꾸면 돼요:
base_url은https://api.apiyi.com/v1로 설정api_key는 프로젝트 자체 환경 변수에서 읽기, 예:os.environ["APIYI_KEY_SEARCH"]
Python 공식 SDK를 쓸 때 핵심은 초기화 한 줄이에요: client = OpenAI(api_key=os.environ["APIYI_KEY_SEARCH"], base_url="https://api.apiyi.com/v1"). 그다음 client.chat.completions.create(model="gemini-3.8-flash", messages=[...])를 호출하면 됩니다. model을 화이트리스트 밖의 모델로 바꾸면 해당 토큰으로는 호출할 수 없어요. 이게 바로 화이트리스트가 구현하려는 효과예요.
5단계: 매주 토큰 로그를 보고, 월말에 토큰별로 대조하기
토큰마다 사용량, 잔여 한도, 호출 로그를 개별로 확인할 수 있어요. 매주 각 토큰의 로그를 한 번씩 보는 걸 권장하며, 두 가지를 중점적으로 확인하세요: 예상치 못한 모델이 나타났는지, 사용량 곡선이 갑자기 올라갔는지. 월말에 토큰별로 집계하면 프로젝트별로 분리된 비용을 얻을 수 있어요.
🎯 기술 제안: 처음 도입할 때는 기본 토큰을 먼저 중지하거나 관리자에게만 남겨 두고, APIYI apiyi.com 토큰 페이지에서 위 계획표대로 하나씩 생성하는 게 좋아요. 이렇게 하면 첫날부터 모든 호출이 로그에서 특정 프로젝트에 귀속될 수 있어요.
기업 멀티모델 관리의 청구서: 모델을 바꾸면 청구서도 바뀌어요
멀티모델 팀이 가장 놓치기 쉬운 점은 모델을 바꾸거나 그룹을 바꾸면 청구서도 함께 바뀐다는 거예요. 아래 가격은 APIYI 모델 목록에서 가져온 것이며, 모두 백만 토큰당 기본 정가입니다. 데이터는 2026-11-16 09:39(UTC+8)에 업데이트됐어요.
| 모델 ID | 입력 가격 | 출력 가격 | 캐시 읽기 | 문서에 표기된 엔드포인트 / 그룹 | 사용 가능 플랫폼 |
|---|---|---|---|---|---|
claude-opus-5-5 |
$4 | $20 | $0.2 | 엔드포인트 chat 및 messages | APIYI apiyi.com |
claude-sonnet-5-5 |
$2 | $10 | $0.1 | 모델 페이지 기준 | APIYI |
qwen3.8-max |
$1.65 | $4.95 | $0.20625 | 엔드포인트 chat 및 messages, 그룹 ClaudeCode, Default, SVIP | APIYI |
gemini-3.8-flash |
$0.75 | $3.75 | $0.075 | Gemini_Reverse 배율 0.5×, Default와 SVIP는 1× | APIYI |
문서에 따르면 종량제 계산 방식은 입력 토큰 × 입력 가격 + 출력 토큰 × 출력 가격이에요. 한 프로젝트가 매월 입력 토큰 100만 개, 출력 토큰 20만 개를 사용한다고 가정하고 정가로 추산하면 다음과 같아요.
claude-opus-5-5: 4 + 0.2 × 20 = $8claude-sonnet-5-5: 2 + 0.2 × 10 = $4qwen3.8-max: 1.65 + 0.2 × 4.95 = $2.64gemini-3.8-flash(Default, 1×): 0.75 + 0.2 × 3.75 = $1.5; Gemini_Reverse(0.5×)를 사용하면 배율을 적용해 약 $0.75
보시다시피 같은 작업량이라도 모델을 바꾸면 비용이 몇 배씩 차이 나고, 그룹을 바꾸면 실제 청구 금액이 바로 달라져요. 그래서 토큰에 화이트리스트와 그룹을 설정하는 것은 사실상 프로젝트의 단가 상한을 정하는 일이에요. 모델과 가격을 확인할 때는 APIYI apiyi.com의 모델 목록을 기준으로 하세요. 특정 모델이 어떤 그룹에 속하고 배율이 얼마인지 확인한 다음, 해당 토큰에 추가하면 돼요. 호출 주소는 https://api.apiyi.com/v1로 통일되어 있고, 모델을 바꿀 때는 model 파라미터만 바꾸면 되며 base_url은 바꿀 필요가 없어요.
팀에서 막 출시된 새 모델을 평가 중이라면, 예를 들어 알리바바 클라우드가 2026-11-16에 출시한 qwen4-max 같은 모델은 현재 모델 목록에 없고 플랫폼 가격 API에서도 조회되지 않는다는 점을 유의하세요. 아직 등록되지 않았으며, 가능한 한 빨리 이 모델을 등록할 예정이에요. 모델과 가격은 플랫폼 모델 목록을 기준으로 합니다. 등록 전에는 어떤 토큰의 화이트리스트 계획에도 넣지 마세요.

기업 다중 모델 관리의 과금 방식: 종량제와 건별 과금을 섞어서 보지 마세요
문서에서는 텍스트 모델에 ‘종량 우선’을 사용할 것을 권장합니다. 건별 과금은 요청 한 건마다 가격이 고정된 방식으로, 주로 이미지와 영상에 쓰입니다. 같은 토큰 하나로 텍스트 작업과 이미지 생성 작업을 모두 실행하면 로그에 토큰 기준 과금 기록과 건별 과금 기록이 동시에 남게 되는데, 단위가 달라 단순히 더할 수 없습니다.
더 안정적인 방법은 텍스트 프로젝트와 이미지 생성·영상 프로젝트를 각각 별도의 토큰으로 만드는 것입니다. 영상처럼 전용 모델은 원래 별도 그룹이 필요하므로, 이렇게 분리하면 그룹 설정과 청구 단위가 모두 더 명확해집니다.
| 과금 방식 | 계산 방식(문서 원문) | 대표 용도 | 토큰 분리 권장 사항 |
|---|---|---|---|
| 종량제 | 입력 token × 입력 단가 + 출력 token × 출력 단가 | 텍스트 대화, 코드, 요약 | 텍스트 프로젝트용으로 별도 하나, 문서에서는 종량 우선 권장 |
| 건별 과금 | 요청 한 건당 고정 가격 | 이미지, 영상 생성 | 이미지 생성 / 영상용으로 별도 하나, 해당 전용 그룹 설정 |
정산과 관련해서 문서에는 충전이 1:7 고정 환율로 결제되며 충전 혜택과 중복 적용할 수 있고, 실제 차감은 콘솔 기준이라고 적혀 있습니다. 구매 절차, 계약, 인보이스 등은 이 문서에서 다루는 범위가 아니므로, 필요하다면 플랫폼에 직접 확인하세요.
💡 선택 제안: 고가 모델(예:
claude-opus-5-5)에는 작은 한도의 토큰을 별도로 만들어 정말 필요한 사람에게만 발급하세요. 일상적인 배치 작업용 토큰에는 낮은 단가의 모델만 넣어 두세요. APIYI apiyi.com에서 모델 목록 기준으로 그룹과 배율을 확인한 뒤 할당하면 월말에 예상치 못한 청구서가 나오는 일을 막을 수 있습니다.

기업 멀티모델 관리 FAQ
Q1: 프로젝트별로 토큰을 나누는 기업 멀티모델 관리란 무엇인가요?
하나의 계정 안에서 프로젝트나 구성원마다 별도의 API 키(토큰)를 만들고, 각 토큰에 할당량, 만료 시각, 모델 화이트리스트, 그룹을 따로 설정하는 방식이에요. 소비와 호출 로그가 토큰별로 분리되어 기록되기 때문에 비활성화와 정산 대조를 프로젝트 단위까지 정확히 맞출 수 있어요.
Q2: 토큰을 많이 만들면 속도 제한이 두 배가 되나요?
아니에요. 문서에 따르면 속도 제한은 계정을 따라가며 토큰 수와는 무관해요. 문서 원문에는 단일 계정에서 일반적으로 100 RPM 이내는 문제가 없다고 되어 있고, TPM은 따로 제한하지 않는다고 적혀 있어요. 다만 이건 문서상의 설명일 뿐 SLA는 아니에요. 토큰을 나누는 건 관리 격리를 위한 것이지, 할당량을 늘리기 위한 게 아니에요.
Q3: 폴백 그룹을 설정하면 실패하지 않나요?
아니에요. 문서 원문 기준으로 토큰 하나에 기본 그룹 1개와 폴백 그룹 최대 2개를 둘 수 있고, 폴백은 기본 그룹이 요청을 처리하지 못할 때 자동으로 전환되어 호출 성공률을 높여주는 역할을 해요. 비즈니스 쪽에서는 여전히 재시도와 디그레이드(성능 저하 대응) 로직을 유지해야 해요.
Q4: 모델 화이트리스트를 설정하지 않으면 어떻게 되나요?
문서 원문: 화이트리스트를 설정하지 않으면 토큰으로 사이트 전체의 200개 이상 선별 모델을 사용할 수 있어요. 관리 측면에서는 위험이 커서 프로젝트가 고가 모델로 손쉽게 전환할 수 있어요. 기업 환경에서는 토큰마다 프로젝트에 실제로 필요한 모델만 넣는 걸 권장해요.
Q5: 이미 OpenAI SDK 코드가 있는데, 프로젝트별 토큰 호출로 바꾸려면 어떻게 하나요?
두 군데만 고치면 돼요. `base_url`을 `https://api.apiyi.com/v1`로 설정하고, `api_key`를 프로젝트 자체 환경 변수에서 읽도록 바꾸면 돼요. 토큰은 APIYI apiyi.com의 토큰 페이지에서 만들고, 모델을 바꿀 때는 `model` 파라미터만 수정하면 돼요.
Q6: 왜 특정 비디오 모델이 제 토큰에서는 호출되지 않나요?
비디오 같은 전용 모델은 별도 그룹이 필요해요. 토큰에 이 그룹이 설정되어 있지 않으면 모델을 사용할 수 없어요. 해당 모델 페이지에서 소속 그룹을 확인한 뒤 토큰 그룹 설정에 추가하면 돼요. 비디오 업무 전용으로 토큰을 따로 만드는 방법도 있어요.
Q7: 같은 모델인데 프로젝트마다 과금이 다른 이유는 무엇인가요?
보통 그룹 배율 차이 때문이에요. 예를 들어 `gemini-3.8-flash`의 모델 페이지에는 Gemini_Reverse 그룹 배율이 0.5×, Default와 SVIP는 1×라고 적혀 있어요. 정산 대조를 할 때는 모델과 그룹을 함께 확인해야 하고, 표시 가격만 보고 판단하면 안 돼요.
Q8: 이런 방식에는 어떤 한계가 있나요?
토큰 분리는 키, 할당량, 로그의 격리 문제를 해결하는 것이지, 계정 속도 제한을 높여주지도 않고 비즈니스 쪽의 재시도와 모니터링을 대체하지도 않아요. 새로 출시된 모델은 플랫폼에 등록된 후에야 화이트리스트에 넣을 수 있어요. 구체적인 가격과 그룹은 APIYI apiyi.com의 모델 목록을 기준으로 해요.
기업 멀티모델 관리 핵심 요점 Key Takeaways
- 토큰이 곧 키예요:
sk-로 시작하며, 프로젝트나 멤버별로 각각 하나씩 만들어 별도로 비활성화할 수 있어요 - 네 가지 제한은 함께 설정: 할당량, 만료 시간, 모델 화이트리스트, 그룹을 함께 설정하고, 하나라도 빠지면 관리 맹점이 생겨요
- 속도 제한은 계정을 따라가요: 문서 원문에 따르면 100 RPM 이내는 일반적으로 문제없고 TPM은 평가하지 않는다고 하며, 토큰을 나눈다고 할당량이 늘어나지는 않아요
- 폴백은 보장이 아니에요: 최대 기본 1개 + 폴백 2개 그룹(문서 원문)이며, 역할은 성공률을 높이는 거예요
- 모델을 바꾸면 청구서가 바뀌어요: 모델 단가와 그룹 배율이 함께 실제 과금을 결정하고, 토큰별로 정산해야 명확하게 보여요
- 텍스트와 이미지 생성은 분리: 사용량 기준과 횟수 기준의 단위가 달라서, 토큰을 나눠 관리하면 정산이 더 편해요
- 통합 진입점: 모든 프로젝트가
https://api.apiyi.com/v1로 접속하고, 토큰만으로 권한과 청구를 구분해요
정리
기업 멀티모델 관리는 모든 벤더 백엔드를 열 수 있는 만능 열쇠가 필요하지 않아요. 대신 권한을 프로젝트별로 분리해야 해요:
- 키는 프로젝트별로 분리: 프로젝트 하나 또는 사람 한 명당 토큰 하나씩, 비활성화와 교체가 서로 영향을 주지 않아요.
- 할당량과 모델에 상한 설정: 할당량으로 총비용을 제어하고, 화이트리스트와 그룹으로 단가를 제어해요.
- 로그는 토큰별로 정산: 매주 이상을 점검하고, 월말에 토큰별로 비용을 집계해요.
이 글의 첫 번째 단계에 따라 먼저 토큰 계획표를 작성한 다음, APIYI apiyi.com의 토큰 페이지에서 하나씩 생성하는 것을 권장해요. 모델, 가격, 그룹을 확인할 때는 플랫폼 모델 목록을 기준으로 하세요. 이렇게 한 번 적용하면 멀티모델 청구서를 명확하게 정리할 수 있어요.
📚 참고 자료
-
APIYI 문서 센터: 토큰 및 그룹, 과금 모드, 모델 전체 목록
- 링크:
docs.apiyi.com - 설명: 경로
/faq/token-and-groups.md,/faq/token-billing-modes.md,/models.md,/models/gemini-3-8-flash.md에 해당하며, 이 글의 토큰·그룹·가격 정보는 모두 이 문서를 기준으로 합니다
- 링크:
-
알리바바 클라우드 바이롄 Qwen4-Max 안내: 제조사 발표 정보
- 링크:
help.aliyun.com/zh/model-studio/qwen4-max - 설명: 해당 모델은 2026-11-16에 제조사가 발표했으며, 플랫폼 등록 상태는 모델 목록을 기준으로 합니다
- 링크:
작성자: APIYI 기술팀
기술 문의: APIYI 웹사이트 홈페이지를 통해 저희에게 연락해 주세요. 토큰과 그룹의 추가 설정 안내는 문서 센터에서 확인하실 수 있습니다
