Blocco gruppi

Ogni modello è servito da uno o più gruppi di provider, ciascuno con un prezzo proprio. Per impostazione predefinita una chiave usa auto: ogni richiesta va al gruppo attivo più economico.

Il blocco sovrascrive questo comportamento per modello. Scegli quali gruppi può usare e la fatturazione resta vincolata alle loro tariffe.

Ogni pagina di modello elenca sotto Group Pricing tutti i gruppi con prezzo di input e output. Il badge di sconto nell'elenco modelli riflette il gruppo più economico.

Apri Chiavi API, crea o modifica una chiave e apri il selettore dei gruppi. Cerca un modello, cliccalo e spunta uno o più gruppi, ordinati dal più economico. I modelli non toccati restano su auto.

I modelli bloccati si ordinano in cima con un badge che mostra il numero dei loro gruppi. Clear all riporta la chiave su auto. L'elenco delle chiavi mostra quelle bloccate come auto +N.

Un modello bloccato viene instradato solo entro i gruppi bloccati, dal più economico, con failover in caso di errori. Il gruppo che serve la richiesta stabilisce la tariffa addebitata.

Abbina un blocco a un'osservazione per sapere quando i suoi gruppi cambiano prezzo o cadono, vedi Notifiche

Per bloccare una sola richiesta senza cambiare la chiave, invia un header X-Group con il nome esatto del gruppo. Sovrascrive il blocco della chiave e il routing auto. Copia i nomi da Group Pricing.

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

L'header deve indicare un gruppo che la chiave può usare, altrimenti la richiesta viene rifiutata. I modelli non bloccati restano sul routing più economico.

Se tutti i gruppi bloccati sono fuori uso mentre altri provider servono ancora il modello, le richieste falliscono con un errore specifico invece di un generico messaggio di sovraccarico:

{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

Allarga o rimuovi il blocco, oppure riprova più tardi. Il modello in sé è attivo.