분그룹이란 무엇인가

MoleAPI 분그룹과 모델 가용성, 가격 정책, 안정성 간의 관계 이해

MoleAPI에서 분그룹은 "어떤 API Key가 어떤 모델 채널과 가격 정책 세트를 사용하는지"로 이해할 수 있습니다.

이는 단순한 표시용 필드가 아니라, 다음에 직접적인 영향을 줍니다:

이 Key로 어떤 모델을 볼 수 있는지
해당 모델 호출 시 어떤 유형의 채널을 사용하는지
적용되는 가격 정책
일부 경우의 안정성과 적합한 사용 시나리오

왜 분그룹이 필요한가

플랫폼이 모든 모델, 모든 가격, 모든 채널을 한데 섞어 두면 사용자가 용도별로 구분하기 어렵습니다.

분그룹이 존재하는 이유는 서로 다른 목표를 나누어 관리할 수 있게 하기 위해서이며, 예를 들면 다음과 같습니다:

테스트 환경과 운영 환경이 서로 다른 분그룹을 사용
비용에 민감한 트래픽은 더 저렴한 그룹 사용
안정성을 우선하는 트래픽은 더 안정적인 그룹 사용
특정 모델은 특정 Key에서만 사용 허용

분그룹을 어떻게 이해하면 되는가

실제에 더 가까운 이해 방식은 다음과 같습니다:

분그룹 = 모델 집합 + 채널 정책 + 가격 정책의 조합

따라서 동일한 모델이라도 서로 다른 분그룹에서는 다음과 같은 차이가 발생할 수 있습니다:

가용성이 다름. 분그룹을 변경하면 모델을 사용할 수 없게 될 수 있음
단가가 다름. 일부는 할인 적용
안정성 경험이 다름. 예를 들어 relay 분그룹은 안정성이 다소 떨어질 수 있음

콘솔의 가격 페이지 왼쪽 필터에서 「사용 가능한 Token 분그룹」을 선택하면, 해당 분그룹에서 표시되는 모델 목록을 확인할 수 있습니다.

MoleAPI 콘솔 가격 페이지: 왼쪽은 사용 가능한 Token 분그룹 필터(예: default, discount)이며, 분그룹 선택 후 오른쪽에 해당 분그룹에서 사용할 수 있는 모델 목록이 표시됨

일반적인 분그룹 유형

아래는 문서에서 가장 자주 등장하고 이해하기 쉬운 몇 가지 유형입니다:

분그룹 유형	특징	적합한 시나리오
`default`	기본 분그룹, 일반적으로 더 안정적이고 범용적임	운영 프로젝트, 장기 사용
`discount`	이벤트 또는 할인 분그룹	비용에 민감하고 이벤트 변동을 확인할 의향이 있는 경우
`relay`	일반적으로 더 저렴하지만, 경험 품질은 구체적인 채널에 더 크게 좌우될 수 있음	테스트, 실험, 비용에 더 민감한 시나리오

실제 기준은 콘솔 및 시스템 공지의 현재 분그룹 정보를 따릅니다.

초보자는 어떻게 선택해야 하는가

처음 연동하는 경우 다음을 권장합니다:

먼저 기본 분그룹으로 전체 흐름을 정상 동작시키기
정상 동작을 확인한 뒤 가격, 모델 커버리지, 안정성에 따라 조정하기

이는 초보자에게는 극단적으로 비용을 아끼는 것보다 먼저 성공적으로 동작시키는 것이 더 중요하기 때문입니다.

언제 분그룹을 명확히 구분해야 하는가

다음과 같은 시나리오에서는 분그룹을 명확히 설계하는 것을 권장합니다:

1. 운영과 테스트 분리

테스트 트래픽과 실제 비즈니스를 동일한 정책에 섞지 마세요.

2. 비용을 통제하고 싶은 경우

가격에 매우 민감하다면, 분그룹은 매우 중요한 조정 수단이 됩니다.

3. 시스템별 권한이 다른 경우

예를 들면:

내부 실험 프로젝트는 더 저렴한 분그룹 사용 가능
정식 제품은 일부 안정적인 모델만 개방

4. 서로 다른 채널의 효과를 관찰하고 싶은 경우

때로는 동일한 모델이라도 서로 다른 분그룹에서 경험이 달라질 수 있으므로, 먼저 소량 트래픽으로 테스트한 뒤 장기 전략을 결정하는 것이 적합합니다.

분그룹과 API Key의 관계

분그룹은 일반적으로 API Key에 설정됩니다. API Key를 생성하거나 편집할 때 「Token 분그룹」에서 해당 Key가 속할 분그룹(예: default, discount, relay)을 선택하며, 서로 다른 분그룹은 서로 다른 Ratio와 모델 범위에 대응합니다.

API Key 생성 또는 편집 시의 Token 분그룹 선택 화면: 입력창 아래에 default(표준 1x), discount(특가 0.8x), relay(중계 0.3x) 등의 분그룹과 해당 Ratio가 표시됨

이는 다음을 의미합니다:

서로 다른 Key가 서로 다른 분그룹을 사용할 수 있음
동일한 계정이 여러 정책을 동시에 가질 수 있음
프로젝트 또는 환경별로 서로 다른 Key를 할당하고, 각 Key에 서로 다른 분그룹을 설정할 수 있음

이 때문에 다음과 같이 자주 권장합니다:

테스트용 Key 하나
운영용 Key 하나
필요하다면 시스템별로 각각 별도의 Key 하나씩

사용 권장 사항

권장 방식

초보자는 먼저 default 사용
환경별로 여러 Key 분리
중요한 비즈니스는 먼저 안정성을 확보한 뒤 더 저렴한 분그룹 고려
배포 전 목표 분그룹에서 실제 테스트 먼저 수행

권장하지 않는 방식

모든 프로젝트가 하나의 Key와 하나의 분그룹을 공용으로 사용
분그룹을 잘 모르는 상태에서 운영 트래픽을 바로 익숙하지 않은 분그룹으로 전환
가격만 보고 모델 가용성과 안정성은 보지 않음

한 줄 권장 사항

먼저 기본 분그룹으로 정상 동작을 확인한 뒤, 비용·모델·안정성 요구사항에 맞춰 분그룹을 최적화하세요.