Api.Airforce
Canali

Canali

Scegli quale canale serve ciascun modello — o lascia decidere al routing automatico.

Che cos’è un canale?

Molti modelli sono raggiungibili tramite più di un canale: rotte indipendenti che servono lo stesso modello con nomi di metodo neutri come standard, direct o reverse. Fissare un canale invia le tue richieste per quel modello su una rotta specifica; per impostazione predefinita la scelta è automatica.

Predefinito: routing automatico

Senza fissaggio, ogni richiesta usa lo smart routing: per ogni richiesta viene scelta la rotta integra più economica in grado di servire il modello. È l’impostazione consigliata e non richiede configurazione.

Scegliere un canale nella dashboard

Apri la scheda Canali nella dashboard. Ogni modello che offre più di un canale è elencato con un indicatore di stato in tempo reale per canale. Seleziona un canale e salva, oppure lascialo su Auto (smart routing). La tua scelta viene salvata sull’account e applicata a tutte le richieste future per quel modello.

Livelli dei canali

Ogni canale ha un livello di accesso, mostrato come badge nel selettore della dashboard. L'assenza di badge indica che il canale è gratis per tutti. Un badge A pagamento indica che richiede un piano o un abbonamento attivo. Un badge A consumo indica che viene addebitato sul saldo del tuo portafoglio a ogni richiesta. Bloccare un canale non cambia mai il prezzo di un modello: stabilisce soltanto quale instradamento gestisce la richiesta.

Scoprire i canali tramite l’API

Aggiungi ?channels=1 all’endpoint dei modelli per elencare tutti i canali. Ognuno viene restituito come pseudo-modello neutro il cui campo group è il modello base a cui appartiene e il cui status riflette lo stato in tempo reale — gli stessi dati usati dal selettore della dashboard.

curl https://api.airforce/v1/models?channels=1

Una risposta ridotta — ogni voce condivide il proprio modello base in group, con il proprio status in tempo reale:

{
  "data": [
    { "id": "claude-opus-4.6_standard", "group": "claude-opus-4.6", "status": "operational", "tier": "free" },
    { "id": "claude-opus-4.6_reverse",  "group": "claude-opus-4.6", "status": "operational", "tier": "paid" }
  ]
}

Fallback e disponibilità

Un canale fissato viene usato finché è integro. Se diventa non disponibile, la richiesta torna automaticamente allo smart routing invece di fallire — quindi fissare un canale non rende mai un modello meno affidabile rispetto al valore predefinito.