Amp

Una connessione Custom URL in Model Routing di Amp — formato API chat-completions, URL di base https://api.kunavo.com/v1, chiave come bearer token — sposta i modelli mappati su una sola chiave, nei livelli che offrono l'opzione.

Connection type    Custom URL            (Model Routing → Add)
API format         chat-completions      OpenAI Chat Completions API, the default
Base URL           https://api.kunavo.com/v1
Key                sk-kn-...             sent as Authorization: Bearer <key>
Headers            —                     nothing extra is needed
Query Parameters   —                     nothing extra is needed
Model mapping      anthropic/claude-opus-4-6 -> claude-opus-4-6
                   anthropic/claude-fable-5  -> claude-fable-5
                   openai/gpt-5.6-sol        -> gpt-5-6-sol

Passo dopo passo

1. Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
2. Apri Model Routing nelle impostazioni personali (gli amministratori dell’area di lavoro possono usare Workspace Model Routing per condividere una connessione con tutti i membri), apri il menu Add e scegli Custom URL.
3. Imposta il formato API su chat-completions, incolla https://api.kunavo.com/v1 come URL di base e inserisci la tua chiave sk-kn-. Amp la invia come Authorization: Bearer <key> in tutti i formati: è l’intestazione con cui Kunavo esegue l’autenticazione, quindi lascia vuoti Headers e Query Parameters.
4. Scrivi la mappatura dei modelli, un pattern per riga. A sinistra va l’ID canonico del modello Amp; a destra di -> va l’ID ricevuto da Kunavo. Le due denominazioni sono diverse (Amp usa openai/gpt-5.6-sol, Kunavo risponde a gpt-5-6-sol), quindi qui la freccia è indispensabile. Usa il selettore Models per inserire gli ID canonici invece di digitarli a memoria.
5. Premi Check Access. Se la mappatura è ampia, Amp elenca i modelli dell’endpoint; se specifica esattamente un modello, invia una richiesta da un token. Poi verifica che il grafo di instradamento sotto l’elenco delle connessioni mostri Kunavo come provider dei modelli mappati e che per tutti gli altri sia ancora indicato Amp.

Verificato rispetto a Documentazione di Model Routing di Amp il 21 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in Amp.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

Quali costi una connessione non sposta

L’instradamento dei modelli cambia chi ti addebita i token e nient’altro. Il calcolo orb di Amp viene conteggiato a parte e al minuto, quindi una connessione lascia invariata questa voce; inoltre gli strumenti non basati su modelli, come la ricerca sul web, continuano a consumare crediti Amp indipendentemente dall’instradamento dei modelli. L’abbonamento Amp che sblocca l’opzione Custom URL ha un costo fisso che si applica già prima del primo token.

Due modelli usati da Amp per impostazione predefinita non compaiono nella tabella sopra perché Kunavo non li offre: i modelli GLM dietro la modalità Low e l’agente secondario Read Thread. Una connessione non può riprodurre la configurazione della modalità più economica di Amp, quindi una mappatura */* lascerà senza avviso quei due modelli su Amp. È il comportamento corretto, non un errore di configurazione: secondo la regola di Amp, tutto ciò che non è fornito da una connessione viene fornito da Amp.