Metti i modelli del catalogo in Raycast AI con un providers.yaml.

Risposta rapida: abilita Custom Providers, modifica un file.

Il percorso di Raycast per endpoint OpenAI-compatible è la funzionalità Custom Providers, rivolta a utenti avanzati e disabilitata di default. Abilitala in fondo alla sezione AI nelle impostazioni di Raycast, usa Reveal Providers Config per aprire la cartella di config, e copia il providers.template.yaml distribuito in providers.yaml. Il file vive in ~/.config/raycast/ai/providers.yaml. Ogni voce provider prende un id, un nome visualizzato, un base_url, e un blocco api_keys; ogni modello che vuoi nel selettore viene dichiarato esplicitamente con il suo id, un nome visualizzato, e la sua finestra di contesto, più un blocco abilities che descrive cosa Raycast può chiedergli. La forma di base_url segue la stessa convenzione degli esempi integrati per modelli locali, che puntano a una radice /v1, quindi il valore di APIsRouter è https://api.apisrouter.com/v1. Il file contiene credenziali, quindi trattalo come qualsiasi file di segreti.

providers:
  - id: apisrouter
    name: APIsRouter
    base_url: https://api.apisrouter.com/v1
    api_keys:
      default: sk-APIsRouter-...
    models:
      - id: claude-sonnet-4-6
        name: Claude Sonnet 4.6
        context: 200000
        abilities:
          temperature:
            supported: true
          tools:
            supported: true
      - id: claude-haiku-4-5-20251001
        name: Claude Haiku 4.5
        context: 200000
        abilities:
          temperature:
            supported: true

Due funzionalità di Raycast che suonano simili, e non lo sono.

Raycast documenta due modi per portare il proprio accesso AI, e cercarne uno fa affiorare in modo affidabile l'altro, quindi la distinzione vale la pena dirla chiaramente. Bring Your Own Keys, la pagina BYOK nel manuale di Raycast, collega la tua chiave personale Anthropic, Google, o OpenAI (OpenRouter su iOS) a Raycast AI. È la funzionalità più semplice, documentata come funzionante senza un abbonamento Pro, ma non è un endpoint personalizzato: le richieste instradano attraverso i server di Raycast per l'unificazione API, e il manuale è esplicito che sono accessibili solo i modelli già disponibili in Raycast AI. Una chiave gateway non si collega lì, perché BYOK non chiede mai un URL. Custom Providers è la funzionalità che questa pagina configura: il tuo base_url, la tua chiave, i tuoi modelli dichiarati, richieste che vanno dove le punti. È il percorso per un gateway multi-fornitore, per server locali, e per qualsiasi modello che l'elenco integrato di Raycast non porta. Lo scambio è l'esplicitezza: Raycast non recupera l'elenco modelli dell'endpoint per te (quella comodità è una richiesta di funzionalità in sospeso), quindi il selettore mostra esattamente ciò che il tuo YAML dichiara, né più né meno.

Dichiarare i modelli onestamente: id, contesto, abilità.

Poiché non c'è autodiscovery, lo YAML è un contratto, e ogni campo al suo interno fa un lavoro reale. L'id del modello deve corrispondere esattamente all'elenco /v1/models del gateway; è ciò che viaggia nella richiesta. Il name è solo l'etichetta che Raycast mostra. Il valore context dice a Raycast quanta cronologia di conversazione può impacchettare in una richiesta, quindi sottostimarlo spreca capacità e sovrastimarlo produce richieste che il modello rifiuta; usa la finestra documentata per l'id che stai dichiarando. Il blocco abilities è quello su cui le persone sbagliano. Dichiara cosa Raycast può assumere di un modello: controllo della temperatura, input visione, messaggi di sistema, uso di tool, sforzo di ragionamento. Dichiarare un'abilità che il modello non ha produce fallimenti runtime confusi dentro le funzionalità di Raycast piuttosto che errori puliti, e omettere una che il modello ha disabilita silenziosamente il comportamento Raycast corrispondente. Inizia minimale, temperature più tools per i modelli che userai con le estensioni AI, e aggiungi abilità man mano che le confermi contro la documentazione del modello. Esiste un'estensione Raycast mantenuta dalla community specificamente per gestire questo file da una UI, con backup automatici prima di ogni modifica, utile da sapere se lo YAML a mano non è la tua preferenza. In entrambi i casi, Raycast legge il file dal disco, quindi dopo aver modificato, concedi un momento alle impostazioni AI o attiva/disattiva la funzionalità per assicurarti che il selettore rifletta il file attuale.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# declare these ids verbatim in providers.yaml

Scegliere modelli per un launcher.

Poiché ogni modello dichiarato fattura tramite la stessa chiave, il ciclo di confronto è un cambio nel selettore: esegui gli stessi comandi rapidi su due id per un giorno, poi leggi la spesa per modello nella console e tieni quello che ha guadagnato il suo posto.

• L'AI del launcher è lavoro a raffica: riassumi questo, riscrivi quello, spiega la selezione. claude-haiku-4-5-20251001 e gemini-3.5-flash ritornano prima che l'animazione della finestra finisca, che è la sensazione che gli utenti Raycast si aspettano.
• Le sessioni AI Chat e la stesura lunga guadagnano claude-sonnet-4-6 o gpt-5.5; dichiarali insieme alla fascia veloce e cambia per task nel selettore.
• Le estensioni AI che chiamano tool hanno bisogno di un modello con uso affidabile dei tool, e del blocco abilities dichiarato per corrispondere; claude-sonnet-4-6 è la prima scelta sicura lì.
• deepseek-v4-flash è la scelta di volume per utenti che collegano AI in ogni campo di testo che toccano; piccoli completamenti costanti si sommano, e la fascia veloce mantiene invisibile l'abitudine sul saldo.
• Dichiara pochi modelli deliberatamente piuttosto che molti speculativamente: ogni voce è una riga del selettore da scorrere, e lo YAML è facile da estendere il giorno in cui hai bisogno di un altro id.

Pagamento a consumo · sotto i prezzi ufficiali

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Modalità di errore specifiche di Raycast.

Configurare BYOK quando intendevi Custom Providers è l'errore di primo livello, e non è colpa tua: le funzionalità condividono uno spazio di ricerca. Se il flusso in cui sei chiede una chiave fornitore ma mai un URL, sei in BYOK, e il gateway non appartiene lì. Torna indietro a Settings, AI, e il toggle Custom Providers in fondo. Il file ignorato di solito significa che il toggle della funzionalità è spento, il file si chiama ancora providers.template.yaml, o lo YAML ha un errore di sintassi, nel qual caso Raycast non ha nulla di valido da caricare e il selettore mostra semplicemente nessun modello personalizzato. Valida lo YAML prima di sospettare qualcosa di più profondo. Un modello che dà errore su alcune funzionalità Raycast ma non su altre è un disallineamento di abilities: le estensioni AI che usano tool falliscono mentre la chat semplice funziona quando tools è stato dichiarato su un modello che ne è privo, o mai dichiarato su uno che ce l'ha. Le richieste rifiutate per dimensione puntano a un valore context sovrastimato. E nota onestamente il confine della piattaforma: Custom Providers è configurato sul Mac, in un file di config locale. Se parte del tuo uso di Raycast è altrove, controlla il manuale per cosa supporta la funzionalità lì prima di dare per scontata la parità.

Chi instrada Raycast AI tramite un gateway.

• Power user che vivono nel launcher e vogliono comandi AI rapidi su id veloci del catalogo senza un abbonamento che decida quali modelli possono toccare.
• Persone che già instradano i propri strumenti di editor e terminale tramite un gateway e vogliono il launcher sulla stessa chiave, un unico log di utilizzo su ogni superficie.
• Utenti che vogliono modelli che l'elenco integrato di Raycast non porta, id DeepSeek e GLM inclusi, dichiarati una volta in YAML e disponibili ovunque nell'app.
• Costruttori di estensioni AI che hanno bisogno di un modello specifico capace di tool dietro la propria estensione, fissato per id piuttosto che soggetto a un elenco ospitato.
• Sviluppatori senza accesso alla fatturazione di un dato fornitore. L'accesso basato su ricarica senza obbligo di carta rimuove la dipendenza dalla registrazione per provider.

Verifica l'endpoint e fai debug del primo comando.

Esegui prima la curl sui modelli e copia gli id dal suo output nello YAML; digitare gli id a memoria è la causa principale di errori model-not-found qui, perché il file è l'unica fonte di modelli che Raycast ha. Poi abilita il toggle, conferma che il selettore mostri i tuoi nomi dichiarati, ed esegui un comando AI rapido sul modello veloce. Un selettore vuoto è il toggle, il nome del file, o la sintassi YAML. Un errore di autenticazione è il blocco api_keys. Un errore non-trovato è un disallineamento di id contro l'elenco che hai appena curlato. Un comando che funziona in chat ma fallisce in un'estensione AI è la dichiarazione abilities su quel modello. Una volta che i comandi fluiscono, la console di APIsRouter mostra il modello per richiesta, i conteggi dei token e la spesa. L'AI del launcher sono centinaia di piccole richieste piuttosto che poche grandi, e il log di utilizzo è dove quel pattern diventa un numero, per modello, per giorno, sulla stessa pagina di ogni altro strumento che instradi tramite il gateway.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Domande frequenti