# Configurare un modello personalizzato in WorkBuddy > Configura un modello personalizzato in WorkBuddy in tre passaggi: apri Aggiungi modello, scegli Personalizzato, inserisci URL OmniaKey API, chiave e ID modello. - Canonical HTML: https://omniakey.com/it/blog/workbuddy-custom-model-setup - Markdown: https://omniakey.com/it/blog/workbuddy-custom-model-setup.md - Published: 2026-08-20 (updated 2026-09-21) - Author: Kiki, COO at OmniaKey - Language: it - Category: API setup - Reading time: 8 min - All posts: https://omniakey.com/blog/llms.txt --- Questa guida utilizza l'attuale interfaccia del modello personalizzato di WorkBuddy. Preparare una chiave OmniaKey API e un ID modello esatto prima di aprire WorkBuddy. > **Il modulo finito:** scegli **Personalizzato**, inserisci `https://api.omniakey.com/v1`, incolla la chiave OmniaKey API e utilizza un ID modello esatto come `deepseek-v4-flash`. Il modulo, i dettagli del modello salvato e il selettore del modello sono stati controllati nell'app macOS che esegue WorkBuddy `v5.3.14`. Le istruzioni ufficiali di Tencent Cloud richiedono almeno `v4.22.15` per questa funzione. |Campo WorkBuddy|Valore| |-|-| |Fornitore|`Custom` nel gruppo **Altro**| |Indirizzo dell'interfaccia|`https://api.omniakey.com/v1`| |API Chiave|Una chiave creata in OmniaKey| |Nome del modello|Ad esempio, `deepseek-v4-flash`| ## Prima di iniziare, prepara due elementi ### Una chiave OmniaKey API Accedi a OmniaKey e apri la [pagina Chiavi API](https://omniakey.com/it/dashboard/tokens): 1. Seleziona **Crea chiave**. 2. Chiamalo `WorkBuddy`, quindi imposta un limite e una scadenza adeguati. 3. Crealo e copia immediatamente la nuova chiave. Mantieni aperta la finestra di dialogo della chiave finché non avrai incollato le credenziali in WorkBuddy. Non inserire la chiave in screenshot, messaggi di chat o file pubblici. L'account necessita inoltre di saldo disponibile o credito di prova. La creazione di una chiave crea solo una credenziale; non garantisce che l'account possa finanziare una richiesta. La stessa chiave funziona in altri strumenti; consulta le guide per [configurare l'API di Cherry Studio](https://omniakey.com/it/blog/cherry-studio-api-setup), [la chiave API personalizzata in Cline](https://omniakey.com/it/blog/cline-custom-api-key) e [configurare Claude Code](https://omniakey.com/it/blog/claude-code-setup). ### Un ID modello esatto Apri il [Catalogo dei modelli OmniaKey](https://omniakey.com/it/models), scegli un modello attualmente disponibile e copia l'ID del modello mostrato nella pagina. Per un primo test, utilizzare: ```text deepseek-v4-flash ``` L'ID deve corrispondere esattamente. Non inserire il nome visualizzato `DeepSeek V4 Flash`, rimuovere i trattini o inventare un alias più breve. ## Passaggio 1: aprire Aggiungi modello Avvia WorkBuddy e apri: ```text System Settings → Models → + Add model ``` Nella pagina Modelli, seleziona **+ Aggiungi modello** nell'angolo in alto a destra. ![WorkBuddy Pagina delle impostazioni dei modelli con il pulsante Aggiungi modello nell'angolo in alto a destra](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/01-open-model-settings.2eba6570.1000.webp) _Passaggio 1: Impostazioni di sistema → Modelli → + Aggiungi modello._ Puoi anche inserire dalla parte inferiore di una nuova attività: ```text Model picker → + Configure custom model ``` Se nessuna delle due voci è disponibile, aggiorna WorkBuddy alla versione `v4.22.15` o successiva. Le attuali istruzioni di Tencent Cloud richiedono almeno questa versione per l'interfaccia. ## Passaggio 2: scegli Personalizzato e completa quattro campi Compila il modulo dall'alto verso il basso. ### 1. Scegli il provider personalizzato Apri il menu Fornitore e seleziona: ```text Custom ``` In `v5.3.14`, appare nel gruppo **Altro**. Non scegliere il OpenAI integrato, il piano token Tencent Cloud o un altro provider perché tali profili non utilizzano l'indirizzo dell'interfaccia OmniaKey. ![Opzione fornitore personalizzato nella parte inferiore del menu Fornitore WorkBuddy](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/02-choose-custom-provider.fabcb941.560.webp) _Passaggio 2: scorri fino alla fine del menu Fornitore e scegli Personalizzato sotto Altro._ ### 2. Immettere l'indirizzo tramite `/v1` In **Indirizzo interfaccia** o **Base URL**, inserisci esattamente: ```text https://api.omniakey.com/v1 ``` > **Non copiare il segnaposto grigio.** Mostra un esempio che termina con `/v1/chat/completions`, ma OmniaKey utilizza Base URL `https://api.omniakey.com/v1` in questo campo. ### 3. Incolla la chiave API Incolla la chiave che hai copiato da OmniaKey in **Chiave API**. Non aggiungere virgolette, spazi o la parola `Bearer`; immettere solo il valore della chiave. ### 4. Immettere il nome del modello In **Nome modello** o **Model ID**, inserisci l'ID catalogo esatto: ```text deepseek-v4-flash ``` Il modulo principale ora dovrebbe essere: ```text Provider: Custom Interface address: https://api.omniakey.com/v1 API Key: [your OmniaKey API key] Model name: deepseek-v4-flash ``` ![Modulo del modello personalizzato WorkBuddy compilato con l'indirizzo dell'interfaccia OmniaKey e il nome del modello deepseek-v4-flash](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/03-fill-omniakey-fields.addb54d9.560.webp) _Esempio completato. La chiave API è intenzionalmente vuota nello screenshot; incolla la tua chiave OmniaKey durante la configurazione di WorkBuddy._ Per il primo test di connessione, lascia i campi rimanenti ai valori predefiniti e assicurati che il **Protocollo personalizzato** sia disattivato. In `v5.3.14`, un nuovo modulo inizia con Tool calling attivato, Ingresso immagine disattivato, Modalità ragionamento disattivato, Protocollo personalizzato disattivato e limiti di input e output predefiniti dal provider. Di seguito viene visualizzata una preimpostazione `deepseek-v4-flash` verificata. ## Passaggio 3: salva, seleziona il modello e testalo Seleziona **Salva** e torna a una nuova attività. Apri il selettore modelli in basso, trova la sezione del modello personalizzato e scegli `deepseek-v4-flash`. Invia un breve messaggio di prova: ```text Reply with exactly: Connection successful ``` Una risposta normale conferma quattro parti della configurazione contemporaneamente: 1. WorkBuddy ha salvato il provider personalizzato. 2. Il Base URL è corretto. 3. La chiave API è accettata e ha credito utilizzabile. 4. La chiave può accedere all'ID del modello selezionato. Infine, apri [OmniaKey Utilizzo](https://omniakey.com/it/dashboard/usage) e conferma che la chiamata venga visualizzata con il modello previsto. Questo chiude il ciclo di verifica da WorkBuddy a OmniaKey. Se il modello salvato non viene visualizzato immediatamente, chiudi e riapri il selettore. Esci completamente e riavvia WorkBuddy se ancora non viene visualizzato. ## Impostazioni avanzate consigliate per il primo test Non modificare diversi controlli di funzionalità prima che la chat di base funzioni. Un nuovo modello personalizzato in WorkBuddy `v5.3.14` inizia con: |Opzione|Predefinito del nuovo formato| |-|-| |Tool calling|Su| |Ingresso immagine|Spento| |Modalità di ragionamento|Spento| |Protocollo personalizzato|Spento| |Limiti di ingresso e di uscita|Impostazioni predefinite del fornitore| Utilizza queste impostazioni predefinite per verificare prima l'URL, la chiave e il nome del modello. Quindi modificare le capacità per il modello. ### Preimpostazione `deepseek-v4-flash` verificata Il modello salvato e le risposte locali riuscite hanno utilizzato questa configurazione: |Opzione|Impostazione `deepseek-v4-flash`| |-|-| |Tool calling|Spento| |Ingresso immagine|Spento| |Modalità di ragionamento|**Attivo**| |Solo ragionamento|Spento| |Consenti ragionamento disabilitante|**Attivo**| |Protocollo personalizzato|**Spento**| |Sforzo di ragionamento predefinito|`Auto (use request-layer default)`| |Sforzi di ragionamento supportati|Lascia deselezionati Basso, Medio, Alto, Molto alto e Massimo| |Limiti di ingresso e di uscita|Impostazioni predefinite del fornitore| WorkBuddy rivela solo Ragionamento, Consenti la disabilitazione del ragionamento e i controlli dello sforzo dopo l'attivazione della modalità Ragionamento. Lasciare lo sforzo su Auto per il primo test. ### Quando abilitare la chiamata dello strumento Abilita **Tool calling** quando WorkBuddy deve leggere file, utilizzare connettori o eseguire attività dell'agente. Il modello deve inoltre supportare chiamate di strumenti strutturati. `deepseek-v4-flash` attualmente dispone del supporto degli strumenti nel catalogo OmniaKey, quindi abilitalo dopo il funzionamento della chat di base e inizia con un'attività di sola lettura. Può rimanere disattivato per un test di chat di sola connessione. ### Quando abilitare l'input di immagini Abilitalo solo per un modello esplicitamente contrassegnato come accettante immagini. Uno switch client non può aggiungere funzionalità di visione a un modello di solo testo. ### Quando abilitare la modalità di ragionamento Abilitatelo quando il catalogo o la documentazione del modello elenca esplicitamente il ragionamento, il pensiero o una modalità simile. Mantieni lo sforzo automatico e Consenti la disabilitazione del ragionamento. Non aggiungere valori di impegno non supportati e non impostare la modalità di solo ragionamento come predefinita per le attività ordinarie. ## Aggiunta di un altro modello Non sovrascrivere una voce del modello funzionante. Apri nuovamente **Aggiungi modello**, mantieni lo stesso URL OmniaKey e la stessa chiave API, sostituisci solo l'ID modello esatto e salvalo come un altro modello personalizzato. Verificare un modello prima di aggiungere il successivo. Quando si presenta un problema, viene chiarito quale voce salvata lo ha introdotto. ## Risoluzione dei problemi in base al sintomo ### Manca la configurazione del modello personalizzato Controllare prima la versione WorkBuddy. Aggiorna a `v4.22.15` o versione successiva, quindi cerca nel selettore del modello di nuova attività o in **Impostazioni di sistema → Modelli**. ### HTTP 401, Chiave API non autorizzata o non valida Copia nuovamente la chiave OmniaKey. Controlla la presenza di spazi bianchi e assicurati di non aver incollato `Bearer`. Conferma che la chiave sia abilitata e non scaduta e che sia il saldo dell'account che il limite della chiave siano utilizzabili. La modifica dell'ID modello non risolve il problema `401`; l'autenticazione non è riuscita prima che la selezione del modello diventasse importante. ### HTTP 404 o endpoint non trovato L'indirizzo deve essere esattamente: ```text https://api.omniakey.com/v1 ``` Non utilizzare il dominio semplice, duplicare `/v1` o aggiungere `/chat/completions`. Assicurati inoltre che il **Protocollo personalizzato** sia disattivato. ### Modello non trovato o `UNKNOWN_MODEL` Copia nuovamente l'ID dal [catalogo dei modelli in tempo reale](https://omniakey.com/it/models). Un nome visualizzato, un alias indovinato o un ID ritirato non è un ID modello corrente valido. ### La chat funziona ma gli strumenti falliscono La connessione del modello base è già funzionante. Controlla l'interruttore Tool calling di WorkBuddy e la capacità dello strumento del modello. Reinserire la chiave o l'URL API non aggiungerà il supporto dello strumento. ### L'immissione dell'immagine non riesce Entrambe le condizioni devono essere vere: il modello supporta le immagini e il controllo di input immagine di WorkBuddy è abilitato. ### Il modello risulta mancante dopo il salvataggio Conferma di aver selezionato **Salva**, quindi riapri il selettore modello. Riavviare WorkBuddy se necessario. Se la voce di configurazione stessa non è disponibile, controlla nuovamente la versione del client. ## Domande frequenti ### Quale URL OmniaKey dovrebbe utilizzare WorkBuddy? Utilizzare solo `https://api.omniakey.com/v1`. È un Base URL; WorkBuddy aggiunge il percorso dell'operazione. ### Ho bisogno di un file `models.json`? No. Questa guida segue l'attuale interfaccia **Configura modello personalizzato**. Le istruzioni precedenti del file di configurazione locale descrivono un percorso di installazione diverso. ### Posso configurare GPT, Claude, Gemini o un altro modello? Sì, quando il modello è attualmente elencato in OmniaKey e supporta il percorso compatibile con OpenAI. Mantieni lo stesso URL e utilizza l'ID modello esatto del catalogo. ### MCP è configurato su questo modulo? No. Questo modulo configura il modello API. MCP e i connettori sono impostazioni WorkBuddy separate. Stabilire una risposta del modello di base prima di aggiungere tali strumenti. ## Riferimenti verificati - [Tencent Cloud: configura e utilizza WorkBuddy](https://cloud.tencent.com/document/product/1823/130064) - [OmniaKey OpenAI compatibile API riferimento](https://docs.omniakey.com/en/api/openai-compatible) - [Catalogo dei modelli live OmniaKey](https://omniakey.com/it/models)