Referência

Nesta página

Tabelas completas do Model Router. Para conceitos e guias de tarefas, comece pela visão geral.

Módulo

ItemValor
Localização no menuMenu principal → Model Router, no grupo AI Modules & Agents
Quem pode acessarSomente Organisation Administrators (instalações Technology Stack).
EscopoPor instalação (selecione a instalação na barra de ferramentas principal)
MoedaUSD

Recargas

ConfiguraçãoValor
Recarga mínima$10
Recarga única máxima$5,000
Predefinições$25, $50, $100, $250, $500, $1000
Forma de pagamentoO cartão de cobrança armazenado da instalação
Prazo de crédito no saldoInstantâneo
ReciboNúmero do recibo + PDF para download de cada recarga; também enviado por e-mail aos contatos de cobrança da instalação

Recarga automática

ConfiguraçãoValor
GatilhoO saldo cai abaixo do seu limite mínimo When balance is below
Valor da recargaO seu valor de Top up by (no mínimo $10)
Frequência de verificaçãoAproximadamente a cada 15 minutos
Tratamento de falhasBanner exibido para: nenhum cartão cadastrado, cartão que exige autenticação, cartão recusado

Uso e conciliação

ItemValor
Conciliação do usoA cada 15 minutos com o saldo pré-pago; exibida em Monthly usage, agrupada por mês do calendário (UTC)
Available balanceEm tempo real: total creditado menos o gasto em tempo real (não apenas o registro conciliado)
Estimated runwayGasto médio diário deste mês projetado em relação ao saldo; exibido como 0 days, 1 day, N days, 365+ days ou Not enough data

Limites de gasto da conta

LimiteRedefiniçãoPredefinições
Limite diárioTodos os dias à meia-noite, no horário local da instalação$25, $50, $100, $250
Limite mensalNo dia 1º de cada mês, no horário local da instalação$50, $100, $250, $500, $1000
Total (teto rígido)Somente redefinição manual (Reset hard cap — contador volta a $0, teto inalterado, período encerrado salvo no histórico de redefinições)—

Qualquer combinação pode estar ativa. Os limites se aplicam a todas as chaves de API e a todos os serviços conectados em conjunto; o saldo pré-pago continua valendo por cima. As violações bloqueiam as solicitações com um erro 402 budget_exceeded até que a janela seja redefinida.

Configurações por chave / por serviço

ConfiguraçãoPadrãoObservações
RótulovazioOpcional; usado para atribuir o uso em Activity e Logs
Tipo de conexão (somente chaves de API)API keyAPI key permanece na lista de chaves de API; External agent aparece em Connected Services
Limite de gasto diáriodesativadoRedefinido no início de cada dia, no fuso horário da instalação
Limite de gasto mensaldesativadoRedefinido no dia 1º de cada mês, no fuso horário da instalação
Teto vitalíciodesativadoGasto total ao longo da vida útil da chave ou do serviço; nunca é redefinido
Solicitações / minIlimitadoExcedê-lo retorna HTTP 429
Tokens / minIlimitadoExcedê-lo retorna HTTP 429
Restringir modelosdesativado (todos os modelos habilitados na instalação)Somente os modelos selecionados podem ser usados com esta chave ou serviço
Substituir proteções da instalaçãodesativado (herda da instalação)Quando ativado, aplica-se a seleção própria da chave ou do serviço — incluindo "none"

Status e ações das chaves de API

StatusSignificado
ActiveA chave funciona.
Provisioning…Exibido brevemente enquanto uma nova chave está sendo configurada.
DisabledA chave está revogada (a linha fica esmaecida); ela pode ser reativada.
AçãoReversível?Efeito
Edit—Altera o rótulo, os limites, os modelos e as proteções.
RotateNãoUm novo segredo é emitido (exibido uma única vez); o segredo antigo deixa de funcionar imediatamente.
RevokeSim (Re-activate)A chave é desativada imediatamente.
DeleteNãoA chave é removida permanentemente.

Modelos

ItemValor
PadrãoTodos os modelos do catálogo habilitados
Automatically enable new modelsQuando ativado, os modelos recém-adicionados ao catálogo são ativados automaticamente para a instalação
Restrição"At least one model must stay enabled."
Predefinições rápidasAll models, Frontier, Western providers, Open weights, Budget (preço de entrada ≤ $1.00 / 1M tokens)
FiltrosStatus (Any/Enabled/Disabled), Região (United States/Europe/China), Capability (Vision, Audio, PDF input, Reasoning)
OrdenaçãoRecommended, Name, Price, Context size — crescente/decrescente
Informações por modeloJanela de contexto, preço de entrada e de saída por 1M tokens, ícones de capacidade (texto, imagem, áudio, PDF), configuração de raciocínio

Roteador Automático

NívelDescrição
SimplePrompts curtos e diretos
MediumTarefas do dia a dia
ComplexTrabalhos difíceis e com várias etapas
ReasoningRaciocínio e análise aprofundados
  • ID do modelo: auto; Usage-priced — cobrado pela tarifa do modelo que o roteador escolhe para cada solicitação.
  • Roteamento por instalação editável em Edit routing (somente modelos habilitados podem ser selecionados; todos os níveis precisam ter um modelo); Reset to default restaura o mapa padrão.
  • Logs/Activity mostram o modelo resolvido; a gaveta da solicitação mostra auto como Requested model.

Diretrizes de Segurança

ProteçãoAção na correspondência
PII maskingMascara os dados pessoais no prompt; a solicitação continua
Secret redactionRemove chaves/tokens/segredos do prompt; a solicitação continua
Prompt-injection shieldBloqueia a solicitação (403 content_policy_violation)
Modelo predefinidoHabilita
NoneNada (padrão)
PII protectionPII masking
Secret redactionSecret redaction
Injection shieldPrompt-injection shield
StrictTodas as três

Filtros de conteúdo

ItemValor
Máximo de filtros por instalação25
Tamanho máximo do padrão300 caracteres
AçõesRedact (substitui as correspondências por [REDACTED]) ou Block (rejeita com 403)
Segurança dos padrõesExpressões regulares inseguras (por exemplo, padrões propensos a backtracking catastrófico) e padrões com mais de 300 caracteres são descartados e não são aplicados
HerançaPara toda a instalação; chaves e serviços com a substituição de proteções usam a sua própria lista

Histórico de transações

O histórico de transações lista somente recargas e ajustes de saldo. O uso é resumido em Monthly usage.

TipoSignificado
Top-upCobrança no cartão que credita o saldo
RefundCobrança reembolsada
AdjustmentCorreção manual do saldo
ItemValor
ColunasDate, Type, Amount, Balance after, Receipt
Recibos em loteMarque as linhas e clique em Download receipts (n)

Uso mensal

ItemValor
AgrupamentoMês do calendário (UTC); o mês atual é marcado como Month to date
ConciliaçãoA cada 15 minutos com o saldo pré-pago
ColunasMonth, Usage, Deductions, Downloads
Tipo de deduçãoUsage charge (gasto de inferência conciliado), listado quando você expande um mês
Downloads por mêsDownload usage statement (PDF) e Download usage detail (CSV)
StatusExtratos de uso, não faturas; somente as recargas com cartão têm recibos

Atividade e logs

ItemValor
Visualizações de ActivityOverview, Trends, Performance, Explore
Predefinições de intervaloLast 24 hours, Last 7 days, Last 30 days, Last 90 days, Year, All time, Custom range
Predefinições de intervalo dos LogsLast 15 minutes, Last hour, Last 24 hours (padrão), Last 7 days, Last 30 days, personalizado; atualização Live Off / 10s / 30s (padrão) / 60s
Opções de agrupamento do ExploreModel, API key / agent, Source, Provider, Status
Limite da exportação CSV bruta25,000 linhas
Tipos de exportaçãoRaw requests; Summary by model / by key & agent / by source / by period (os resumos abrangem dias inteiros)
Conteúdo armazenadoSomente metadados — nunca o conteúdo dos prompts ou das respostas

Respostas de erro da API

URL base: exibido em Settings → Service Access & API Keys → Connecting to the API (por exemplo, https://app.performancehub.co/ai/v1). Os erros usam o envelope da OpenAI { "error": { "message", "type", "code" } }.

HTTPtypecodeSignificado
401invalid_request_errorinvalid_api_keyChave de API ausente ou credenciais de serviço conectado inválidas
401invalid_request_error—Chave de API desconhecida ou revogada ("Invalid API key")
402insufficient_quotainsufficient_creditsSaldo pré-pago esgotado (ou, para serviços conectados, a instalação não está habilitada)
402insufficient_quotabudget_exceededUm limite de gasto foi atingido (instalação, chave ou serviço conectado); o corpo inclui window, resetsAt, timezone, docsUrl
403invalid_request_error—"Model Router is not enabled for this facility" (chaves de API) ou "Facility has no provisioned inference key" (a chave não tem uma chave de inferência associada)
403invalid_request_errorcontent_policy_violationBloqueado por um filtro de conteúdo ou pelo escudo contra injeção de prompt
429——Limite de taxa de solicitações/min ou tokens/min excedido
502server_error—Serviço de inferência upstream indisponível (tente novamente)

Uma falha inesperada durante a verificação da chave de API retorna HTTP 500 "Something went wrong"; tente a solicitação novamente.

GET /v1/models continua disponível com saldo zero.