제공업체의 카탈로그는 세 종류의 항목을 한 페이지에 섞어 놓습니다. 지금 호출할 수 있는 모델, 요청할 수 있는 모델, 제공업체가 테스트만 한 모델입니다. 표에서는 비슷해 보입니다. 하지만 그 모델을 대상으로 코드를 쓸 때는 완전히 다릅니다. 이 글은 BroadNet 카탈로그를 실제 예로 들어 이들을 구분하는 방법을 보여 줍니다. BroadRouter는 BroadNet의 자체 사이트이므로, 여기서 인용한 BroadNet 페이지는 모두 2026년 11월 15일에 확인했고, 중요한 부분은 바꿔 말하지 않고 그대로 인용합니다.
카탈로그 항목의 세 종류는 무엇인가요?
| 상태 | 의미 | 필요한 것 | 호출 방법 |
|---|---|---|---|
| 라이브 | 공개 요금표에 가격과 함께 게시됨 | 계정과 자격 있는 키 | 공개 base URL에서 공개 모델 ID로 |
| 문의 시 제공 | 제공업체가 배포할 수 있지만 셀프서비스는 아님 | 문의와 계약 | 대개 비공개 모델 ID나 엔드포인트로 |
| 연구용 | 테스트, 벤치마크, 양자화 또는 탈락 | 없음. 판매용이 아님 | 호출할 수 없음 |
함정은 세 번째 줄입니다. 연구 결과를 정직하게 공개하는 제공업체는 판매하는 것보다 훨씬 많은 모델을 나열합니다. 이는 제공업체가 모델을 어떻게 고르는지에 대한 유용한 정보입니다. 제공한다는 주장은 아닙니다.
BroadNet 카탈로그에서는 어떻게 보이나요?
BroadNet의 모델 카탈로그는 세 가지를 모두 한 페이지에 다음 순서로 보여 줍니다.
- “Live on the Inference API”. 상자에는 “These models are on the rate card today.”(번역: 이 모델들은 현재 요금표에 있습니다.)라고 적혀 있습니다.
- “Available on request”. 항목 세 개입니다. BroadNet이 파인튜닝한 Cohere Transcribe Arabic, Qwen3-VL 30B-A3B Instruct, Qwen3-VL 8B Instruct입니다. 이들의 모델 페이지에는 “private id issued per customer”(번역: 고객별로 비공개 ID 발급)라고 적혀 있습니다.
- “The catalogue”. BroadNet이 연구실에서 돌려 봤다고 밝힌 모든 모델(2026년 9월 측정 기준 약 270개)로, PROD(실제 트래픽 처리), SERVED, BENCH, QUANT, FT, RULED OUT 태그가 붙어 있습니다. 언어 모델, 음성 인식, 텍스트 음성 변환, OCR, 임베딩, 이미지·동영상 생성 등으로 분류되어 있습니다.
- “Remote and API models benchmarked”. BroadNet의 표현으로는 “About 90 models we never ran on our hardware but pushed through our safety, routing and Arabic harnesses.”(번역: 자체 하드웨어에서 돌린 적은 없지만 안전성, 라우팅, 아랍어 테스트 하네스에 통과시켜 본 약 90개 모델.)입니다. Anthropic, OpenAI, Google, Meta 등의 모델이 나옵니다.
셀프서비스 키로 호출할 수 있는 것은 첫 번째 그룹뿐입니다. 세 번째와 네 번째 그룹에는 텍스트 음성 변환, 이미지 생성, 임베딩 모델이 들어 있는데, BroadNet의 공개 API는 이 중 어느 것도 제공하지 않습니다. 표에서 FLUX나 Claude 모델을 봤다면 BroadNet이 그것을 측정했다는 뜻이지, 거기에 요청을 보낼 수 있다는 뜻이 아닙니다. BroadNet이 탈락시킨 모델의 이유는 BroadNet이 제외한 모델에, 하드웨어 쪽은 BroadNet의 GPU 하드웨어와 서빙에 정리되어 있습니다.
어느 출처가 요금표인가요?
기계 판독용 출처입니다. BroadNet은 pricing.json을 공개하며, API 레퍼런스는 이를 “the same file our pricing and plans pages are built from”(번역: 가격 및 플랜 페이지를 만드는 바로 그 파일)이라고 설명합니다. 모델마다 다음을 제공합니다.
id:model로 보낼 정확한 문자열.status:live또는on_request.paid_only: 조건을 충족하는 충전 후에만 열리는 모델이면 true.- 가격,
context_length, 채팅 모델의modalities, 전사 모델의languages.
2026년 11월 15일 피드에는 라이브 모델 6개가 있었습니다. DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B, Gemma 4 VL 26B, BroadNet Transcribe Arabic, BroadNet Transcribe입니다. API 레퍼런스의 모델 표에도 같은 ID 6개가 있었습니다.
같은 날 카탈로그 페이지의 “Live on the Inference API” 상자에는 그중 4개만 있었습니다. GLM 5.3과 Qwen3.8 27B가 빠져 있었고, 2026년 11월 16일에 다시 확인했을 때도 마찬가지였습니다(Qwen3.8 27B는 아래쪽 연구실 표에 SERVED로 나왔습니다). 어느 페이지가 갱신이 늦은 것인지는 알 수 없고, 유료 요청으로 확인할 수도 없었습니다. 이런 일은 어느 제공업체의 사이트에서나 흔하며, 그래서 무엇을 보낼지는 피드와 API 레퍼런스를 읽고 테스트해야 합니다.
GET /v1/models는 믿을 수 있나요?
제공업체마다 그것이 무엇을 뜻하는지 확인하세요. OpenAI Python SDK는 models.list()가 “the currently available models”(번역: 현재 사용 가능한 모델)를 나열한다고 문서화하며, 많은 도구가 이를 호출해 모델 선택 목록을 채웁니다. 다른 OpenAI 호환 API는 이를 다르게 구현합니다.
BroadNet의 API 레퍼런스에는 “Use the model IDs in this reference for direct API requests. GET /v1/models supplies public catalogue metadata for external monitors.”(번역: API를 직접 요청할 때는 이 레퍼런스의 모델 ID를 사용하세요. GET /v1/models는 외부 모니터링용 공개 카탈로그 메타데이터를 제공합니다.)라고 적혀 있습니다. 2026년 11월 15일에 키 없이 호출했더니 broadnet/cohere-transcribe-arabic과 broadnet/cohere-transcribe만 반환되었고, 각각 input_modalities, capacity 같은 필드와 false로 설정된 is_ready 플래그가 있었습니다. 라이브 채팅 모델 4개는 하나도 없었습니다. 따라서 /v1/models만으로 모델 목록을 만드는 도구는 BroadNet의 채팅 모델을 하나도 보여 주지 않습니다. OpenAI 호환 base URL 글에서 다른 클라이언트에 대해 설명한 것처럼 모델 ID를 직접 입력하세요.
코드로 상태를 확인하려면?
이 스크립트는 BroadNet의 공개 피드와 /v1/models를 둘 다 키 없이 읽고, 모델마다 상태와 접근 조건을 출력합니다. 모델이 추가되거나, 문의 시 제공으로 옮겨지거나, 폐기되는 것을 잡아내도록 CI에서 돌려도 안전합니다.
import json, urllib.request
FEED = "https://inference.broadnet.ai/pricing.json"
MODELS = "https://inference.broadnet.ai/v1/models"
def get(url):
req = urllib.request.Request(url, headers={"User-Agent": "catalogue-check/1.0"})
with urllib.request.urlopen(req, timeout=30) as r:
return json.load(r)
feed = get(FEED)
assert feed["schema_version"] == 1, "unknown feed schema: re-read the docs before trusting it"
print(f"prices updated {feed['updated']}")
for m in feed["models"]:
status = m.get("status", "live") # docs: live or on_request
access = "top-up required" if m.get("paid_only") else "open from sign-up"
inputs = ", ".join(m.get("modalities", [])) or f"audio, {m.get('language_count', len(m.get('languages', [])))} language(s)"
print(f"{status:10} {m['id']:36} {m['kind']:5} {inputs:22} {access}")
listed = {m["id"] for m in get(MODELS)["data"]}
callable_ = {m["id"] for m in feed["models"] if m.get("status", "live") == "live"}
print("live in the feed but not in /v1/models:", sorted(callable_ - listed))
print("in /v1/models but not live in the feed:", sorted(listed - callable_))
2026년 11월 15일에 실제로 실행한 결과는 다음과 같습니다.
prices updated 2026-11-14
live broadnet/deepseek-v4.1-flash chat text, image top-up required
live broadnet/glm-5.3 chat text top-up required
live broadnet/qwen3.8-27b chat text, image top-up required
live broadnet/gemma-4-26b-a4b chat text, image open from sign-up
live broadnet/cohere-transcribe-arabic stt audio, 1 language(s) open from sign-up
live broadnet/cohere-transcribe stt audio, 14 language(s) open from sign-up
live in the feed but not in /v1/models: ['broadnet/deepseek-v4.1-flash', 'broadnet/gemma-4-26b-a4b', 'broadnet/glm-5.3', 'broadnet/qwen3.8-27b']
in /v1/models but not live in the feed: []
“Open from sign-up”은 paid_only가 없는 행에 저희 스크립트가 붙이는 레이블이며, 피드의 필드가 아닙니다. BroadNet에서는 $5 상당의 초기 크레딧으로 쓸 수 있다는 뜻입니다. schema_version 확인은 문서를 따른 것입니다. 문서에 따르면 버전은 기존 필드의 의미가 바뀔 때만 바뀌고, 새 필드는 언제든 추가될 수 있습니다.
마지막 확인은 요청입니다. 모델 ID와 짧은 프롬프트로 cURL 빠른 시작 호출을 보내면, 그 모델이 내 키로 라이브 상태일 때 200이, 아니면 기계 판독용 코드가 담긴 오류가 돌아옵니다.
“문의 시 제공”은 실제로 어떤 모습인가요?
BroadNet의 문의 시 제공 모델 페이지를 보면 무엇이 다른지 알 수 있습니다. 예를 들어 Qwen3-VL 30B-A3B 페이지에는 가격 대신 “Ask for access” 버튼이 있고, 모델 ID는 “private id issued per customer”로 표시되며, 컨텍스트는 16K 토큰입니다. BroadNet이 파인튜닝한 Cohere Transcribe Arabic도 같은 방식입니다. BroadNet의 API 레퍼런스는 그 구조를 설명합니다. 전용 엔드포인트, BroadNet의 아랍어 파인튜닝 모델, 그 밖의 문의 시 제공 모델은 “are reached with a private ID issued with the endpoint.”(번역: 엔드포인트와 함께 발급되는 비공개 ID로 접근합니다.)
코드와 계획에 미치는 영향 세 가지:
- 하드코딩할 공개 ID가 없습니다. 제공업체가 ID를 발급하기 전에는 요청을 작성할 수 없으니, 모델 ID는 코드가 아니라 설정에 두세요.
- 한도가 다릅니다. 문의 시 제공 배포는 공개 요금표의 어떤 모델과도 컨텍스트 창, 속도 제한, 리전이 다를 수 있습니다. 서면으로 요청하세요.
- 조건이 다릅니다. BroadNet 약관에 따르면 전용 엔드포인트와 예약 용량은 별도의 서면 계약을 따릅니다. 가격, 가용성, 처리 위치는 공개 페이지가 아니라 그 계약에서 정해집니다.
모델 위에 무언가를 만들기 전 5단계 확인
어느 제공업체든, 의존할 계획인 모델마다 이 과정을 거치세요.
- 블로그 글, 모델 페이지, 벤치마크 표만이 아니라 요금표나 피드에서 찾으세요.
- API 레퍼런스에서 정확한 ID를 복사하세요. 이름은 조금씩 달라집니다. 버전 접미사, “Flash”와 “Pro” 변형,
broadnet/같은 제공업체 접두사가 모두 중요합니다. - 접근 조건을 확인하세요. 내 키나 플랜으로 쓸 수 있나요? BroadNet에서
paid_only모델은 충전이 필요하고, DeepSeek 세션 플랜은 DeepSeek V4.1 Flash에만 적용됩니다. - 이미지, 도구, 구조화된 출력처럼 필요한 기능이 그 모델에 있는지 문서에서 확인하세요. 한 모델에 있는 기능이 다음 모델에도 있다는 보장은 없습니다.
- 현실적인 프롬프트로 요청을 하나 보내고, 응답의 요청 ID를 보관하세요. 중요한 모델이라면 CI에서 반복하세요.
카탈로그에서 절대 추론하면 안 되는 것은 무엇인가요?
- 벤치마크한 모델이 판매 중이라는 것. 연구 표의 한 줄은 측정 결과입니다.
- 문의 시 제공이 곧 제공된다는 것. 그것은 대화를 시작한다는 뜻입니다. BroadNet은 문의 시 제공 모델, 전용 엔드포인트, 지역별 처리를 문의 페이지를 통한 상담으로 안내합니다. 전용 엔드포인트 계획하기를 참고하세요.
- 어떤 기능이 모든 모델에 적용된다는 것. BroadNet 문서에 따르면 비전은 “offered only where the model row explicitly says images or vision”(번역: 모델 행에 이미지나 비전이 명시된 경우에만 제공)되며, 도구 호출은 GLM 5.3과 Qwen3.8 27B에 대해서만 문서화되어 있습니다. 텍스트, 음성, 비전은 각 입력을 받는 모델에 작업을 연결해 줍니다.
- 오늘의 목록이 영구적이라는 것. BroadNet 약관(§7.4)에 따르면 BroadNet은 모델이나 기능을 변경, 중단, 폐기할 수 있으며, 가능한 경우 카탈로그 페이지에서 합리적인 사전 고지를 합니다. 셀프서비스에는 가용성 약정이 없고, 서비스 수준은 별도의 서면 계약에서만 정해집니다.
- 모델 이름이 어디서나 같은 모델을 뜻한다는 것. BroadNet의 원격 모델 목록에는 “GLM 5.3 Flash”가 있는데, 이는 요금표의
broadnet/glm-5.3과 다릅니다. 항상 정확한 ID를 복사하세요.
같은 확인 과정은 어느 제공업체에나 적용됩니다. 나머지 질문은 제공업체 체크리스트에 있습니다.
BroadNet Inference의 역할
BroadNet Inference의 라이브 모델과 가격은 같은 pricing.json으로 만든 모델 페이지와 가격 페이지에 있습니다. BroadNet이 문의 시 제공하는 모델은 문의 시 제공 아래에 따로 나와 있습니다. broadnet.ai의 연구 카탈로그는 BroadNet이 모델을 어떻게 고르는지, 그리고 일부를 탈락시킨 공개된 이유를 알 수 있어 읽어 볼 만하지만, 그 안의 모든 행은 제안이 아니라 근거 자료로 다루세요.
