Riferimento

In questa pagina

Tabelle complete per Model Router. Per i concetti e le guide alle attività, inizia dalla panoramica.

Modulo

VoceValore
Posizione nel menuMenu principale → Model Router, nel gruppo AI Modules & Agents
Chi può accederviSolo gli Organisation Administrator (strutture Technology Stack).
AmbitoPer struttura (seleziona la struttura nella barra degli strumenti principale)
ValutaUSD

Ricariche

ImpostazioneValore
Ricarica minima$10
Ricarica singola massima$5,000
Importi predefiniti$25, $50, $100, $250, $500, $1000
Metodo di pagamentoLa carta di pagamento memorizzata della struttura
Tempi di accredito del saldoImmediato
RicevutaNumero di ricevuta + PDF scaricabile per ogni ricarica; inviata anche via email ai contatti di fatturazione della struttura

Ricarica automatica

ImpostazioneValore
AttivazioneIl saldo scende sotto la soglia When balance is below
Importo della ricaricaIl tuo importo Top up by (minimo $10)
Frequenza dei controlliCirca ogni 15 minuti
Gestione degli erroriBanner mostrato per: nessuna carta registrata, carta che richiede autenticazione, carta rifiutata

Utilizzo e riconciliazione

VoceValore
Riconciliazione dell'utilizzoOgni 15 minuti con il saldo prepagato; mostrata in Monthly usage, raggruppata per mese di calendario (UTC)
Available balanceIn tempo reale: totale accreditato meno la spesa in tempo reale (non solo il registro riconciliato)
Estimated runwaySpesa giornaliera media di questo mese proiettata sul saldo; visualizzata come 0 days, 1 day, N days, 365+ days o Not enough data

Limiti di spesa dell'account

LimiteAzzeramentoImporti predefiniti
Daily limitOgni giorno a mezzanotte, ora locale della struttura$25, $50, $100, $250
Monthly limitIl 1° di ogni mese, ora locale della struttura$50, $100, $250, $500, $1000
Total (hard cap)Solo azzeramento manuale (Reset hard cap: contatore a $0, tetto invariato, periodo chiuso salvato nella cronologia degli azzeramenti)—

Può essere attiva qualsiasi combinazione. I limiti si applicano a tutte le chiavi API e a tutti i servizi connessi complessivamente; il saldo prepagato resta comunque valido in aggiunta. I superamenti bloccano le richieste con un errore 402 budget_exceeded finché la finestra non si azzera.

Impostazioni per chiave / per servizio

ImpostazionePredefinitoNote
EtichettavuotaFacoltativa; usata per attribuire l'utilizzo in Activity e Logs
Tipo di connessione (solo chiavi API)API keyAPI key resta nell'elenco delle chiavi API; External agent compare in Connected Services
Limite di spesa giornalierodisattivatoSi azzera all'inizio di ogni giorno, fuso orario della struttura
Limite di spesa mensiledisattivatoSi azzera il 1° di ogni mese, fuso orario della struttura
Tetto complessivodisattivatoSpesa totale nell'arco di vita della chiave o del servizio; non si azzera mai
Richieste / minIllimitateIl superamento restituisce HTTP 429
Token / minIllimitatiIl superamento restituisce HTTP 429
Restrict modelsdisattivato (tutti i modelli attivati per la struttura)Solo i modelli selezionati sono utilizzabili con questa chiave o questo servizio
Override facility guardrailsdisattivato (eredita dalla struttura)Quando è attivo, si applica la selezione propria della chiave o del servizio, compresa l'opzione "none"

Stati e azioni delle chiavi API

StatoSignificato
ActiveLa chiave funziona.
Provisioning…Mostrato per poco tempo mentre una nuova chiave viene configurata.
DisabledLa chiave è revocata (la riga appare attenuata); può essere riattivata.
AzioneReversibile?Effetto
Edit—Modifica etichetta, limiti, modelli, guardrail.
RotateNoViene emesso un nuovo segreto (mostrato una sola volta); il vecchio segreto smette di funzionare immediatamente.
RevokeSì (Re-activate)La chiave viene disattivata immediatamente.
DeleteNoLa chiave viene rimossa in modo permanente.

Modelli

VoceValore
PredefinitoTutti i modelli del catalogo attivati
Automatically enable new modelsQuando è attivo, i modelli appena aggiunti al catalogo vengono attivati automaticamente per la struttura
Vincolo"At least one model must stay enabled."
Preset rapidiAll models, Frontier, Western providers, Open weights, Budget (prezzo di input ≤ $1.00 / 1M token)
FiltriStatus (Any/Enabled/Disabled), Region (United States/Europe/China), Capability (Vision, Audio, PDF input, Reasoning)
OrdinamentoRecommended, Name, Price, Context size, in ordine crescente/decrescente
Informazioni per modelloFinestra di contesto, prezzo di input e output per 1M token, icone delle capacità (testo, immagini, audio, PDF), impostazione di ragionamento

Auto Router

LivelloDescrizione
SimplePrompt brevi e semplici
MediumAttività quotidiane
ComplexLavoro difficile e in più passaggi
ReasoningRagionamento e analisi approfonditi
  • ID del modello: auto; Usage-priced: viene addebitata la tariffa del modello scelto dal router per ogni richiesta.
  • Instradamento per struttura modificabile tramite Edit routing (sono selezionabili solo i modelli attivati; ogni livello deve avere un modello); Reset to default ripristina la mappa standard.
  • Logs/Activity mostrano il modello scelto; il pannello della richiesta mostra auto come Requested model.

Filtri di sicurezza

GuardrailAzione in caso di corrispondenza
PII maskingMaschera i dati personali nel prompt; la richiesta prosegue
Secret redactionRimuove chiavi/token/segreti dal prompt; la richiesta prosegue
Prompt-injection shieldBlocca la richiesta (403 content_policy_violation)
ModelloAttiva
NoneNulla (predefinito)
PII protectionPII masking
Secret redactionSecret redaction
Injection shieldPrompt-injection shield
StrictTutti e tre

Filtri dei contenuti

VoceValore
Numero massimo di filtri per struttura25
Lunghezza massima del pattern300 caratteri
AzioniRedact (riscrive le corrispondenze in [REDACTED]) o Block (rifiuta con 403)
Sicurezza dei patternLe espressioni regolari non sicure (ad es. pattern soggetti a backtracking catastrofico) e i pattern oltre i 300 caratteri vengono scartati e non applicati
EreditarietàA livello di struttura; le chiavi e i servizi con la sostituzione dei guardrail usano un proprio elenco

Cronologia delle transazioni

La cronologia delle transazioni elenca solo ricariche e rettifiche del saldo. L'utilizzo è riepilogato in Monthly usage.

TipoSignificato
Top-upAddebito sulla carta che accredita il saldo
RefundAddebito rimborsato
AdjustmentCorrezione manuale del saldo
VoceValore
ColonneDate, Type, Amount, Balance after, Receipt
Ricevute multipleSeleziona le righe, poi Download receipts (n)

Utilizzo mensile

VoceValore
RaggruppamentoMese di calendario (UTC); il mese corrente è contrassegnato come Month to date
RiconciliazioneOgni 15 minuti con il saldo prepagato
ColonneMonth, Usage, Deductions, Downloads
Tipo di detrazioneUsage charge (spesa di inferenza riconciliata), elencata quando espandi un mese
Download per meseDownload usage statement (PDF) e Download usage detail (CSV)
StatoRendiconti di utilizzo, non fatture; solo le ricariche con carta hanno ricevute

Attività e log

VoceValore
Viste di ActivityOverview, Trends, Performance, Explore
Intervalli predefinitiLast 24 hours, Last 7 days, Last 30 days, Last 90 days, Year, All time, Custom range
Intervalli predefiniti di LogsLast 15 minutes, Last hour, Last 24 hours (predefinito), Last 7 days, Last 30 days, personalizzato; aggiornamento Live Off / 10s / 30s (predefinito) / 60s
Opzioni di raggruppamento di ExploreModel, API key / agent, Source, Provider, Status
Limite di esportazione CSV non elaborata25,000 righe
Tipi di esportazioneRichieste non elaborate; riepilogo per modello / per chiave e agente / per origine / per periodo (i riepiloghi coprono giorni interi)
Contenuto memorizzatoSolo metadati: mai il contenuto dei prompt o delle risposte

Risposte di errore dell'API

URL di base: mostrato in Settings → Service Access & API Keys → Connecting to the API (ad es. https://app.performancehub.co/ai/v1). Gli errori usano la struttura OpenAI { "error": { "message", "type", "code" } }.

HTTPtypecodeSignificato
401invalid_request_errorinvalid_api_keyChiave API mancante o credenziali del servizio connesso non valide
401invalid_request_error—Chiave API sconosciuta o revocata ("Invalid API key")
402insufficient_quotainsufficient_creditsSaldo prepagato esaurito (oppure, per i servizi connessi, la struttura non è attivata)
402insufficient_quotabudget_exceededRaggiunto un limite di spesa (struttura, chiave o servizio connesso); il corpo include window, resetsAt, timezone, docsUrl
403invalid_request_error—"Model Router is not enabled for this facility" (chiavi API) oppure "Facility has no provisioned inference key" (la chiave non ha una chiave di inferenza associata)
403invalid_request_errorcontent_policy_violationBloccata da un filtro dei contenuti o dalla protezione dalla prompt injection
429——Superato il limite di frequenza di richieste/min o token/min
502server_error—Servizio di inferenza a monte non disponibile (riprova)

Un errore imprevisto durante la verifica della chiave API restituisce HTTP 500 "Something went wrong"; riprova la richiesta.

GET /v1/models resta disponibile con saldo zero.