TypingMind

Aggiungi OneProvider a TypingMind come custom model. TypingMind richiede l'indirizzo completo dell'endpoint, non una base URL.

TypingMind non ha un campo per la base URL: il modulo del custom model accetta l'indirizzo completo dell'endpoint e invia le richieste esattamente lì, senza aggiungere nulla. Il campo integrato per la chiave API di Claude (Anthropic) comunica direttamente con Anthropic, quindi in TypingMind una chiave OneProvider funziona solo come custom model.

1. Aggiungi un custom model

1. In TypingMind apri Models nella barra laterale sinistra, fai clic su Add custom model e resta su Create Manually.
2. Name: un nome qualsiasi, per esempio OneProvider claude-opus-5-5.
3. Model ID: l'id esatto dalla pagina dei modelli , per esempio claude-opus-5-5. Il nome visualizzato «Claude Opus 5.5» non è un id.
4. Context Length: la finestra di contesto del modello, dalla stessa pagina.

2. API Type, Endpoint URL e chiave

Nella scheda Authentication scegli uno dei due tipi di API e compila i campi esattamente come qui sotto. La stessa chiave OneProvider vale per entrambi.

Claude Messages API (modelli Claude)

API Type: Claude Messages API
Endpoint URL: https://api.oneprovider.dev/v1/messages
Authentication Type: API Key via HTTP Header
Header Key: x-api-key
Header Value: sk-your-key-here
Model ID: claude-opus-5-5

OpenAI Chat Completions API (modelli GPT e Claude)

API Type: OpenAI Chat Completions API
Endpoint URL: https://api.oneprovider.dev/v1/chat/completions
Authentication Type: API Key via HTTP Header
Header Key: Authorization
Header Value: Bearer sk-your-key-here
Model ID: gpt-6.1-terra

Header Value è la parola Bearer, uno spazio e poi la chiave completa. Anche gli id Claude come claude-sonnet-5-5 funzionano su questo percorso.

3. Temperature e opzioni della richiesta

• Lascia temperature al valore predefinito. I modelli Claude 5.x rispondono 400 a una temperature diversa da quella predefinita; se l'hai cambiata nelle impostazioni del modello o della chat di TypingMind, ripristinala.
• Route requests via TypingMind Cloud non serve: la nostra API accetta richieste direttamente dal browser (CORS).

4. Test & Save

Fai clic su Test & Save, poi scegli il nuovo modello in una chat.

Ogni modello è un custom model a sé: ripeti i passaggi per ogni id che ti serve, con la stessa Endpoint URL e la stessa chiave.

Quale modello scegliere

claude-opus-5-5 è adatto a chat lunghe e impegnative, claude-sonnet-5-5 è la scelta bilanciata predefinita e claude-haiku-5-5 quella veloce ed economica; i modelli GPT come gpt-6.1-terra passano per il tipo OpenAI Chat Completions API. Scrivi l'id esattamente come nella pagina dei modelli ; le tariffe sono nella pagina dei prezzi .

Errori comuni e soluzioni

404 Not Found

L'Endpoint URL è una base URL (https://api.oneprovider.dev/v1 o https://api.oneprovider.dev). Usa https://api.oneprovider.dev/v1/messages per il tipo Claude Messages API oppure https://api.oneprovider.dev/v1/chat/completions per il tipo OpenAI Chat Completions API.

Il modello non viene trovato o non è disponibile

Il Model ID deve essere l'id esatto, per esempio claude-opus-5-5, non il nome visualizzato del modello. Copialo dalla pagina dei modelli .

400 per la temperature

I modelli Claude 5.x accettano solo la temperature predefinita. Ripristina temperature in TypingMind al valore predefinito e invia di nuovo il messaggio.

401 authentication_error

Claude Messages API: Header Key x-api-key e la chiave completa come valore. OpenAI Chat Completions API: Header Key Authorization e Bearer sk-... come valore.

La chiave non funziona nel campo Claude integrato di TypingMind

Quel campo invia le richieste ad Anthropic, che non riconosce le chiavi OneProvider. Aggiungi OneProvider come custom model, come descritto sopra.

FAQ

TypingMind richiede una base URL o l'endpoint completo?

L'endpoint completo. TypingMind non aggiunge alcun percorso, quindi l'indirizzo deve terminare con /v1/messages o /v1/chat/completions.

Mi serve Route requests via TypingMind Cloud?

No. La nostra API accetta richieste dal browser (CORS), quindi TypingMind può chiamarla direttamente.

Posso usare i modelli GPT?

Sì: scegli il tipo OpenAI Chat Completions API e un id GPT come gpt-6.1-terra.

Una sola voce può coprire tutti i modelli?

No. Ogni modello è un custom model a sé, con la stessa Endpoint URL e la stessa chiave.

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .