Come utilizzare la chiave API di CometAPI in TypingMind per la chat AI

TL;DR

TypingMind è un'interfaccia di chat AI flessibile che consente di collegare GPT, Claude, DeepSeek e altri modelli supportati utilizzando le proprie chiavi API. Integrando CometAPI tramite una connessione compatibile con OpenAI, puoi accedere a più modelli AI senza configurare account provider separati. Questa guida spiega come aggiungere un modello personalizzato utilizzando la tua chiave API di CometAPI e l'endpoint Chat Completions, inviare il primo messaggio e risolvere gli errori comuni di configurazione. Ti serviranno una chiave API di CometAPI, credito disponibile sull’account e accesso alle impostazioni dei modelli personalizzati di TypingMind. Inizia con un prompt testuale di base, quindi abilita le funzionalità avanzate secondo necessità. È incluso anche un esempio facoltativo con Bash e cURL per testare la connessione all'API.

Key Takeaways

• Una sola chiave API, più modelli: accedi ai provider supportati tramite un unico account CometAPI.
• Integrazione compatibile con OpenAI: configura un endpoint standard Chat Completions senza un SDK personalizzato.
• Selezione flessibile dei modelli: registra in TypingMind più modelli supportati da CometAPI.
• Fatturazione separata: l’inferenza del modello è fatturata da CometAPI; la licenza di TypingMind è separata.

What is TypingMind 

TypingMind è un'interfaccia di chat AI che si connette ai modelli tramite le chiavi API che fornisci. Ti offre un unico luogo per selezionare i modelli e gestire le conversazioni. TypingMind fornisce l'interfaccia; il servizio API collegato gestisce le richieste al modello e la fatturazione dell'utilizzo.

CometAPI offre a TypingMind una connessione API condivisa per i modelli supportati da più provider, inclusi GPT, Claude, Gemini e DeepSeek. Puoi gestire accesso API e fatturazione tramite un unico account CometAPI, quindi creare voci di modelli personalizzati separati in TypingMind per i modelli che vuoi utilizzare. Questo rende più semplice provare modelli diversi per scrittura, coding o domande quotidiane senza configurare un account API separato per ogni provider.

What Do You Need Before Connecting CometAPI to TypingMind?

Crea una chiave nella sezione API Keys dell’account CometAPI, seguendo le istruzioni per la creazione delle chiavi. Usa una chiave dedicata per questa connessione, così potrai revocarla senza interrompere integrazioni non correlate. Non includere la chiave in screenshot, documenti condivisi o repository pubblici.

CometAPI supporta più famiglie di modelli, incluse GPT, Claude, Gemini e DeepSeek; non è limitata a GPT-6 Luna. Questo tutorial utilizza GPT-6 Luna (ID modello: gpt-6-luna) solo come esempio per la tabella di configurazione e il test da terminale. Puoi scegliere un modello diverso dal catalogo dei modelli di CometAPI, purché il tuo account possa accedervi e la relativa route supporti OpenAI Chat Completions.

Quando utilizzi un altro modello, sostituisci gpt-6-luna con l’ID esatto di quel modello sia in TypingMind sia nella richiesta cURL. Aggiorna anche nome visualizzato, lunghezza del contesto, prezzi e impostazioni delle funzionalità in base al modello selezionato. Le impostazioni del modello di esempio non devono essere considerate valide per ogni modello.

Usa la configurazione sottostante. TypingMind richiede l’URL completo dell’endpoint; un URL base dell’SDK che termina con /v1 è un campo diverso e non deve essere utilizzato qui.

How Do You Add CometAPI to TypingMind?

Create a custom model

Apri TypingMind, seleziona Models e scegli Add custom model. Mantieni Create Manually selezionato. Il flusso di configurazione manuale documenta questi controlli.

Enter the model details

Copia il nome e l’ID del modello dalla tabella di configurazione. Se è richiesta la Context Length, usa il limite documentato del modello selezionato; la finestra di contesto documentata di GPT-6 Luna è di 1,050,000 token. Un limite di contesto è un’impostazione di capacità, non un invito a inviare così tanti token.

Set the endpoint and authentication

In Authentication, inserisci il tipo di API, l’endpoint, la chiave dell’header e il valore dell’header dalla tabella. Sostituisci YOUR_COMETAPI_API_KEY con la tua chiave reale. Inserisci uno spazio dopo Bearer e non usare virgolette.

Entrambi gli screenshot provengono dalla guida ufficiale di TypingMind. Il modulo di autenticazione vuoto illustra il posizionamento dei campi; inserisci il tuo endpoint CometAPI, l’ID del modello e la chiave.

Test and save the connection

Inizia con la chat testuale e lascia non impostati gli override facoltativi della richiesta. Clicca Test & Save, seleziona il modello salvato e invia: “Spiega le REST API rispetto ai WebSocket in tre frasi.” Una risposta visibile dell’assistente conferma una connessione di base. Invia un messaggio di follow-up per verificare che la conversazione continui.

Enable optional capabilities

Inizia con la chat testuale. Abilita streaming, prompt di sistema, input di immagini, strumenti o controlli di ragionamento solo quando supportati. Testa separatamente le funzionalità avanzate.

Le Impostazioni delle funzionalità di TypingMind offrono controlli automatici e manuali. Considera il rilevamento come punto di partenza: verifica ogni funzionalità con il modello e la route selezionati. Mantieni la configurazione di base funzionante, così potrai rimuovere l’override più recente se un test di funzionalità fallisce.

How Do You Check the CometAPI Request Outside TypingMind?

Usa questo test facoltativo quando Test & Save fallisce. Invia una richiesta minima usando la stessa chiave e lo stesso ID modello, seguendo il formato documentato della richiesta Chat Completions di CometAPI. Non richiede modifiche alla configurazione di TypingMind.

Set the key for the current Bash session

Esegui quanto segue in Bash, incluso Git Bash o WSL su Windows. Incolla la chiave al prompt nascosto. Questi comandi sono sintassi Bash e non devono essere incollati in PowerShell senza modifiche.

read -r -s -p "CometAPI API key: " COMETAPI_API_KEYprintf '\n'export COMETAPI_API_KEY

Send a minimal chat request

curl --include --silent --show-error \  https://api.cometapi.com/v1/chat/completions \  -H "Authorization: Bearer $COMETAPI_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-6-luna",    "messages": [      {"role": "user", "content": "Explain API gateways in one sentence."}    ]  }'

Ispeziona choices[0].message.content per il testo dell’assistente. Se cURL restituisce un errore HTTP, leggi il body della risposta prima di modificare le impostazioni. Se ha successo mentre TypingMind fallisce, confronta endpoint, chiave, ID modello e override facoltativi, quindi controlla il pannello Network del browser. Una richiesta da terminale riuscita conferma quel percorso di richiesta; non verifica l’accesso dal browser né ogni funzionalità del modello.

Remove the temporary environment variable

unset COMETAPI_API_KEY

How to Troubleshoot TypingMind Connection Errors

Usa il body della risposta e il pannello Network del browser per identificare la richiesta che fallisce. I controlli seguenti sono punti di partenza, non una diagnosi basata solo sul codice di stato. Mantieni le credenziali fuori da screenshot e messaggi di supporto.

Un’API può funzionare in Python o cURL ma fallire in un browser a causa di restrizioni cross-origin. Non esporre una chiave API senza restrizioni tramite un proxy pubblico non sicuro solo per bypassare il CORS.

FAQ

Posso mantenere una connessione TypingMind esistente mentre aggiungo CometAPI?

Sì: crea una voce di modello personalizzato separata con un nome visualizzato distintivo invece di modificare la voce del provider esistente. Mantieni disponibili l’endpoint e le impostazioni del modello originali mentre convalidi la connessione CometAPI. Esegui i test prima in una nuova chat, così la lunghezza o gli allegati di una conversazione precedente non oscurano un errore di configurazione di base.

Come dovrei ruotare una chiave CometAPI usata in TypingMind?

Crea una chiave sostitutiva, aggiorna ogni voce di modello personalizzato che usa la chiave vecchia e testa una nuova richiesta da ciascuna voce. Revoca la chiave vecchia dopo che la sostituzione funziona. Se la chiave vecchia è stata esposta, revocala immediatamente e ripristina le connessioni interessate con una nuova chiave.

Perché la stima dei costi di TypingMind può differire dalla fattura di CometAPI?

TypingMind stima l’uso in base alle tariffe inserite nelle sue Impostazioni di Pricing. Tariffe non aggiornate o differenze nella contabilizzazione di cache, livelli di contesto o token di ragionamento possono produrre una discrepanza. Confronta le tariffe correnti del modello e l’utilizzo di una richiesta specifica con le informazioni di fatturazione di CometAPI; non considerare una stima lato client come addebito finale.

Conclusion

Per collegare CometAPI a TypingMind, crea un modello personalizzato manuale, inserisci l’endpoint completo Chat Completions, aggiungi l’header Authorization e testa un messaggio di solo testo. Mantieni una configurazione funzionante prima di aggiungere funzionalità opzionali. Quando la configurazione fallisce, una richiesta cURL minima aiuta a distinguere gli errori di account o API dalle impostazioni del browser e del frontend.