Id dei modelli e varianti

Gli id dei modelli su api14 hanno la forma provider/model, ad esempio openai/gpt-5-mini. Passa l'id nel campo model di qualsiasi richiesta.

{ "model": "anthropic/claude-sonnet-4.5" }

Trovare gli id dei modelli

• Sfoglia la pagina dei modelli: ogni modello con id, prezzi, lunghezza del contesto e funzionalità.
• Chiama GET /models da codice; filtra per categoria con ?category=image. Vedi Modelli.

Alcuni esempi:

Gli id distinguono maiuscole e minuscole. Un id sconosciuto o disattivato restituisce 404 model_not_found.

Varianti

Una variante è un suffisso dopo i due punti che cambia il modo in cui la richiesta viene servita. Le varianti funzionano con lo stesso modello di base; si applicano la disponibilità e le regole di accesso del modello di base.

{ "model": "openai/gpt-5-mini:online" }

:nitro e :floor sono scorciatoie per l'ordinamento dei provider, equivalenti a provider: { sort: "throughput" } e provider: { sort: "price" }. Vedi Instradamento dei provider e fallback.

Fallback tra modelli

Invia un array models per provare altri modelli quando il primo fallisce o non è disponibile:

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

Ogni modello dell'elenco deve essere disponibile e consentito per la tua chiave e il tuo piano, altrimenti la richiesta viene rifiutata prima di essere inviata. Il campo model della risposta indica quale ha risposto, e paghi il prezzo di quel modello.

Liste consentite e piani

• Una chiave con una lista di modelli consentiti può usare solo gli id elencati; gli altri id restituiscono 403 model_not_allowed.
• Ogni piano, Free compreso, include tutte le categorie di modelli, anche video e musica/audio. Un piano limitato ad alcune categorie restituisce 403 plan_required per le altre. Vedi Prezzi e fatturazione.

Modifiche ai modelli

Il catalogo si aggiorna automaticamente. I nuovi modelli compaiono da soli; i modelli rimossi restituiscono 404 model_not_found. Fissa gli id esatti in produzione e usa i fallback con models per la resilienza.