BroadRouter
Começar

Live, sob consulta, pesquisa: como ler um catálogo de modelos

Pela equipe da BroadNet Inference · 7 min de leitura · Publicado em · Atualizado em

Um modelo que você pode chamar tem um ID de API exato, um preço publicado e status live na tabela de preços ou no feed de preços do provedor. Modelos sob consulta exigem contato e geralmente um ID privado. Entradas de pesquisa registram o que o provedor testou e não podem ser chamadas. Leia o feed e a referência da API e confirme com uma requisição.

Os catálogos dos provedores misturam três tipos de entrada numa mesma página: modelos que você pode chamar agora, modelos que você pode pedir e modelos que o provedor só testou. Numa tabela eles parecem iguais. Quando você escreve código em cima deles, são muito diferentes. Este post mostra como distingui-los, usando o catálogo da BroadNet como exemplo. O BroadRouter é o site da própria BroadNet, então verificamos em 15 de novembro de 2026 cada página da BroadNet citada aqui e, onde importa, citamos em vez de parafrasear.

Status O que significa Do que você precisa Como chamar
Live Na tabela de preços pública, com preço publicado Uma conta e uma chave com acesso O ID público do modelo na base URL pública
Sob consulta O provedor pode implantar, mas não por autoatendimento Um contato e um acordo Geralmente um ID de modelo ou endpoint privado
Pesquisa Testado, avaliado em benchmark, quantizado ou descartado Nada; não está à venda Não dá

A armadilha é a terceira linha. Um provedor que publica a sua pesquisa com honestidade vai listar muito mais modelos do que vende. É uma informação útil sobre como ele escolhe modelos. Não é uma declaração de disponibilidade.

Como o catálogo da BroadNet mostra isso?

O catálogo de modelos da BroadNet traz os três numa só página, nesta ordem:

  1. “Live on the Inference API” (tradução: live na Inference API). O quadro diz: “These models are on the rate card today.” (tradução: estes modelos estão na tabela de preços hoje).
  2. “Available on request” (tradução: disponíveis sob consulta). Três entradas: um fine-tune da BroadNet do Cohere Transcribe Arabic, o Qwen3-VL 30B-A3B Instruct e o Qwen3-VL 8B Instruct. As páginas deles dizem “private id issued per customer” (tradução: ID privado emitido por cliente).
  3. “The catalogue” (tradução: o catálogo). Todos os modelos que a BroadNet diz ter rodado no seu laboratório (cerca de 270, contagem de setembro de 2026), marcados como PROD (atendeu tráfego real), SERVED, BENCH, QUANT, FT ou RULED OUT. Estão agrupados em modelos de linguagem, fala para texto, texto para fala, OCR, embeddings, geração de imagem e vídeo, entre outros.
  4. “Remote and API models benchmarked” (tradução: modelos remotos e via API avaliados). Nas palavras da BroadNet: “About 90 models we never ran on our hardware but pushed through our safety, routing and Arabic harnesses.” (tradução: cerca de 90 modelos que nunca rodamos no nosso hardware, mas que passamos pelos nossos testes de segurança, roteamento e árabe). Cita modelos da Anthropic, OpenAI, Google, Meta e outros.

Só o primeiro grupo pode ser chamado com uma chave de autoatendimento. O terceiro e o quarto grupos incluem modelos de texto para fala, geração de imagens e embeddings, nenhum deles oferecido pela API pública da BroadNet. Ver o FLUX ou um modelo Claude na tabela diz que a BroadNet o mediu, não que você pode enviar uma requisição a ele. Os motivos que a BroadNet dá para os rejeitados estão resumidos em modelos que a BroadNet descartou, e o lado de hardware em hardware de GPU e serving da BroadNet.

Qual fonte é a tabela de preços?

A legível por máquina. A BroadNet publica o pricing.json, que a referência da API descreve como “the same file our pricing and plans pages are built from” (tradução: o mesmo arquivo a partir do qual nossas páginas de preços e de planos são geradas). Para cada modelo ele informa:

  • id: a string exata a enviar como model;
  • status: live ou on_request;
  • paid_only: true quando o modelo só é liberado depois de uma recarga elegível;
  • preços, context_length, modalities para modelos de chat e languages para transcrição.

Em 15 de novembro de 2026, o feed listava seis modelos live: DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B, Gemma 4 VL 26B, BroadNet Transcribe Arabic e BroadNet Transcribe. A tabela de modelos da referência da API listava os mesmos seis IDs.

No mesmo dia, o quadro “Live on the Inference API” da página do catálogo mostrava quatro deles: ficaram de fora o GLM 5.3 e o Qwen3.8 27B, e continuavam de fora quando conferimos de novo em 16 de novembro de 2026. (O Qwen3.8 27B aparecia mais abaixo como SERVED na tabela do laboratório.) Não sabemos qual página está desatualizada, e não conseguimos confirmar com uma requisição paga. Isso é normal no site de qualquer provedor, e é por isso que você deve ler o feed e a referência da API para saber o que enviar, e depois testar.

Dá para confiar no GET /v1/models?

Verifique o que ele significa em cada provedor. O SDK Python da OpenAI documenta models.list() como a lista de “the currently available models” (tradução: os modelos disponíveis no momento), e muitas ferramentas o chamam para preencher um seletor de modelos. Outras APIs compatíveis com a OpenAI o implementam de outro jeito.

A referência da API da BroadNet diz: “Use the model IDs in this reference for direct API requests. GET /v1/models supplies public catalogue metadata for external monitors.” (tradução: use os IDs de modelo desta referência para requisições diretas à API. O GET /v1/models fornece metadados públicos do catálogo para monitores externos). Quando o chamamos em 15 de novembro de 2026, sem chave, ele devolveu apenas broadnet/cohere-transcribe-arabic e broadnet/cohere-transcribe, cada um com campos como input_modalities, capacity e uma flag is_ready definida como false. Nenhum dos quatro modelos de chat live estava listado. Então uma ferramenta que monta a lista de modelos só a partir de /v1/models não mostraria nenhum modelo de chat da BroadNet; digite o ID do modelo à mão, como o post sobre base URLs compatíveis com a OpenAI descreve para outros clientes.

Como verificar o status no código?

Este script lê o feed público da BroadNet e o /v1/models, ambos sem chave, e imprime o status e o acesso de cada modelo. É seguro rodá-lo na CI para detectar quando um modelo é adicionado, passa para sob consulta ou é aposentado.

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_))

Rodando ao vivo em 15 de novembro de 2026, ele imprimiu:

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” é o rótulo que o nosso script dá a uma linha sem paid_only, não um campo do feed; na BroadNet, significa que o crédito inicial de $5 cobre o modelo. A verificação de schema_version segue a documentação, que diz que a versão só muda quando um campo existente muda de significado, e que campos novos podem aparecer a qualquer momento.

A verificação final é uma requisição. Uma chamada do quickstart com cURL com o ID do modelo e um prompt curto devolve 200 se o modelo estiver live para a sua chave, e um erro com um código legível por máquina se não estiver.

Como é, na prática, um modelo “sob consulta”?

As páginas de modelos sob consulta da BroadNet mostram o que muda. A página do Qwen3-VL 30B-A3B, por exemplo, tem um botão “Ask for access” (tradução: pedir acesso) no lugar do preço, lista o ID do modelo como “private id issued per customer” e informa um contexto de 16K tokens. O fine-tune da BroadNet do Cohere Transcribe Arabic funciona do mesmo jeito. A referência da API da BroadNet explica o mecanismo: endpoints privados, os fine-tunes de árabe dela e outros modelos sob consulta “are reached with a private ID issued with the endpoint.” (tradução: são acessados com um ID privado emitido junto com o endpoint).

Três consequências para o seu código e os seus planos:

  • Nenhum ID público para fixar no código. Você não consegue escrever a requisição até o provedor emitir o ID, então mantenha o ID do modelo na configuração, não no código.
  • Limites diferentes. Uma implantação sob consulta pode ter janela de contexto, rate limit e região diferentes de tudo o que está na tabela de preços pública. Peça-os por escrito.
  • Termos diferentes. Os Termos da BroadNet dizem que endpoints privados e capacidade reservada seguem um acordo escrito separado. Preços, disponibilidade e local de processamento vêm desse acordo, não das páginas públicas.

Uma verificação em cinco passos antes de construir em cima de um modelo

Faça isto para todo modelo do qual você pretende depender, em qualquer provedor:

  1. Encontre-o na tabela de preços ou no feed, não só num post de blog, numa página de modelo ou numa tabela de benchmark.
  2. Copie o ID exato da referência da API. Os nomes variam: sufixos de versão, variantes “Flash” e “Pro” e prefixos de provedor como broadnet/ fazem diferença.
  3. Verifique o acesso. A sua chave ou o seu plano cobre o modelo? Na BroadNet, modelos paid_only exigem recarga, e os planos por sessão do DeepSeek cobrem só o DeepSeek V4.1 Flash.
  4. Verifique na documentação a capacidade de que você precisa nesse modelo, como imagens, ferramentas ou saída estruturada. Uma capacidade num modelo não diz nada sobre o próximo.
  5. Envie uma requisição com um prompt realista e guarde o ID da requisição da resposta. Repita na CI se o modelo for crítico.
  • Que um modelo avaliado em benchmark está à venda. Uma linha numa tabela de pesquisa é uma medição.
  • Que sob consulta significa em breve. Significa uma conversa. A BroadNet apresenta modelos sob consulta, endpoints privados e processamento regional como consultas pela página de contato; veja planejar um endpoint privado.
  • Que uma capacidade vale para todos os modelos. A documentação da BroadNet diz que visão é “offered only where the model row explicitly says images or vision” (tradução: oferecida apenas onde a linha do modelo menciona explicitamente imagens ou visão), e documenta tool calling só para o GLM 5.3 e o Qwen3.8 27B. Texto, fala ou visão associa tarefas aos modelos que aceitam cada tipo de entrada.
  • Que a lista de hoje é permanente. Os Termos da BroadNet (§7.4) dizem que ela pode alterar, suspender ou aposentar um modelo ou recurso e, quando possível, dar aviso razoável na página do catálogo. O autoatendimento não tem compromisso de disponibilidade; níveis de serviço só existem num acordo escrito separado.
  • Que o nome de um modelo indica o mesmo modelo em todo lugar. A lista de modelos remotos da BroadNet inclui o “GLM 5.3 Flash”, que não é o broadnet/glm-5.3 da tabela de preços. Sempre copie o ID exato.

As mesmas verificações valem para qualquer provedor. O nosso checklist de provedores tem o restante das perguntas a fazer.

Onde entra a BroadNet Inference

Os modelos live e os preços da BroadNet Inference estão nas nossas páginas de modelos e preços, geradas a partir do mesmo pricing.json. Os modelos que a BroadNet oferece sob consulta estão listados à parte em sob consulta. O catálogo de pesquisa em broadnet.ai vale a leitura para entender como a BroadNet escolhe modelos e pelos motivos publicados para rejeitar alguns, mas trate cada linha dele como evidência, não como oferta.

Perguntas frequentes

Como sei se posso chamar um modelo numa API?

Ele precisa ter um ID de API exato, um preço publicado e status live na tabela de preços ou no feed de preços legível por máquina do provedor, e a sua chave precisa ter acesso a ele. Depois envie uma requisição pequena. Uma resposta 200 com esse ID de modelo é a prova.

O que significa “disponível sob consulta”?

O provedor pode implantar o modelo para você, mas não por uma chave de autoatendimento. Você entra em contato, combina os termos e geralmente recebe um ID de modelo ou endpoint privado. Na BroadNet, os modelos sob consulta são acessados com um ID privado emitido junto com o endpoint.

Por que não consigo chamar um modelo que aparece numa tabela de pesquisa ou de benchmark?

Porque a tabela registra o que o provedor testou, não o que ele vende. O catálogo da BroadNet lista modelos de texto para fala, geração de imagens e embeddings que ela avaliou, e cerca de 90 modelos remotos que ela diz nunca ter rodado no próprio hardware. Nenhum tem ID de API público nem preço.

O GET /v1/models lista todos os modelos que posso usar?

Nem sempre. Na API da OpenAI ele lista os modelos disponíveis no momento, mas outros provedores o implementam de outro jeito. Em 15 de novembro de 2026, o da BroadNet devolvia só os dois modelos de transcrição, e a documentação diz que o endpoint fornece metadados do catálogo para monitores; use os IDs da referência da API.

Quais modelos da BroadNet exigem recarga?

No pricing.json de 15 de novembro de 2026, DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B estavam com paid_only, então são liberados depois de uma recarga elegível. O Gemma 4 VL 26B e os dois modelos de transcrição ficavam abertos desde o cadastro, com o crédito inicial.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity