Vai al contenuto
Risorse per sviluppatori
Risorse per sviluppatori

Jan

Aggiungi RunAPI come provider Jan e verifica una chat.

Visualizza Markdown

Connetti Jan a RunAPI con un provider compatibile con OpenAI personalizzato. Crea una Chiave API RunAPI standard nella Guida all’Autenticazione prima di continuare.

Installa Jan

Scarica e installa l’applicazione desktop dal sito web ufficiale di Jan, quindi apri le impostazioni.

Aggiungi il provider RunAPI

  1. Apri Settings -> Model Providers -> Add Provider.
  2. Imposta il formato API su OpenAI-compatible e il nome del provider su RunAPI.
  3. Imposta il Base URL su https://runapi.ai/v1, inserisci la tua chiave API RunAPI e crea il provider.
  4. Seleziona un modello rilevato oppure aggiungi un identificatore preciso dal Model Catalog nell’area Models del provider.

Il formato API selezionato è compatibile con OpenAI, quindi questo Base URL include /v1. Un provider che utilizza un altro protocollo pubblico deve utilizzare la configurazione client specifica di quel protocollo.

Quando il provider viene salvato, Jan invia una richiesta a {base_url}/models, che si risolve in https://runapi.ai/v1/models. Se il modello necessario non viene restituito, utilizza l’azione manuale + anziché modificare il Base URL.

Configura le funzionalità del modello

Jan non deduce tutte le funzionalità per un provider personalizzato. Abilita solo il comportamento di visione, strumenti o audio che il modello selezionato dichiara nel Catalogo Modelli. Un’opzione UI non può aggiungere una funzionalità API non supportata.

Verifica la connessione

Avvia una nuova chat, seleziona il modello RunAPI e invia Reply with the word connected. Una risposta normale, completa o in streaming, conferma che il provider e il modello sono attivi.

Risoluzione dei problemi

  • Ogni richiesta restituisce 404: assicurati che il Base URL includa /v1; Jan aggiunge il percorso dell’operazione.
  • Non compare nessun modello: conferma che il Base URL sia https://runapi.ai/v1, quindi aggiungi manualmente l’identificatore esatto del modello.
  • La creazione del provider restituisce 401 o 403: sostituisci la chiave con una Chiave API RunAPI standard valida, non una Management Key.
  • I controlli delle funzionalità non corrispondono al modello: configura ogni modello personalizzato in base alle funzionalità dichiarate anziché affidarti al rilevamento automatico.
  • Una chiave di fallback non viene tentata: Jan ruota le chiavi per 401, 403 o 429; altri errori non attivano la rotazione delle chiavi.

Per il comportamento del protocollo condiviso, utilizza la Guida introduttiva all’API LLM. Per i campi di richiesta e risposta, utilizza il Riferimento API Chat Completions.