Home → Guide → Chatbox con un'API personalizzata: host, percorso, Claude e generazione di immagini

Chatbox con un'API personalizzata: host, percorso, Claude e generazione di immagini

In Chatbox un'API personalizzata può fallire in tre punti: la coppia Host API / Percorso API, la modalità Claude che vuole /v1 mentre Claude Code lo vieta, e il Creatore di immagini, che ignora del tutto i provider personalizzati. Abbiamo letto il codice sorgente di Chatbox 1.23.5, provato ogni combinazione sul nostro gateway e raccolto gli errori di utenti reali.

Aggiungere il provider

1. Apri Impostazioni → Fornitore di modelli e fai clic su Aggiungi provider personalizzato. Dagli un nome e imposta Modalità API su Compatibile con OpenAI API.
2. Inserisci https://apiclan.us come Host API e lascia vuoto il Percorso API.
3. Incolla la tua chiave API dalla console.
4. Fai clic su Recupera per caricare i modelli del gruppo della chiave, poi su Verifica.

Host API	Percorso API	Chatbox chiama
https://apiclan.us	(vuoto)	/v1/chat/completions ✓
https://apiclan.us/v1	/chat/completions	/v1/chat/completions ✓
https://apiclan.us	/chat/completions	/chat/completions ✗ 404

Chatbox aggiunge /v1 all'host solo quando il Percorso API è vuoto. Appena scrivi un percorso, l'host viene usato così com'è: https://apiclan.us con /chat/completions salta /v1 e restituisce un 404 con corpo vuoto. Lascia vuoto il percorso oppure metti /v1 nell'host.

Aggiungere Claude

Ci sono due modi, con una regola dell'indirizzo diversa:

Modalità API	Host API	Chatbox chiama
Compatibile con OpenAI API	https://apiclan.us	/v1/chat/completions ✓
Compatibile con Claude API	https://apiclan.us/v1	/v1/messages ✓
Compatibile con Claude API	https://apiclan.us	/messages ✗ 404

Il più semplice è un secondo provider personalizzato in modalità Compatibile con OpenAI API con una chiave di un gruppo Claude: 29 delle 43 richieste Chatbox registrate erano claude-fable-5-1 inviato proprio così. Se preferisci Compatibile con Claude API, l'host deve finire con /v1, perché Chatbox aggiunge solo /messages. È l'opposto di Claude Code, dove ANTHROPIC_BASE_URL non deve contenere /v1.

Generare immagini in Chatbox

Il Creatore di immagini elenca solo il provider OpenAI integrato (oltre a quello di Chatbox e a Gemini). I provider personalizzati sono programmati per non avere modelli di immagine e falliscono con Provider doesnt support image generation.

1. Apri Impostazioni → Fornitore di modelli → OpenAI (quello integrato, non il tuo provider personalizzato).
2. Imposta l'Host API su https://api.apiclan.us e incolla una chiave creata in un gruppo immagini.
3. Aggiungi il modello gpt-image-2.5 e imposta il Tipo di modello su Immagine.
4. Apri il Creatore di immagini e scegli gpt-image-2.5.

Tieni i modelli di chat nel provider personalizzato: una chiave appartiene a un solo gruppo, quindi la chiave immagini nel provider OpenAI non può usare i modelli di chat GPT. Qui usiamo api.apiclan.us perché un'immagine grande può richiedere minuti e l'indirizzo principale interrompe le risposte dopo 100 secondi. La nostra richiesta di prova nel formato di Chatbox ha restituito un'immagine 1024×1024 in 21 secondi.

Quanto costano richieste reali di Chatbox

Tutte le 43 richieste Chatbox ricevute dal nostro gateway nei 30 giorni fino al 12 ottobre 2026, tutte in streaming su /v1/chat/completions:

Modello	Richieste	Primo token (mediana)	Media per messaggio
claude-fable-5-1	29	5.2 s	$0.039
gpt-6-astra	8	1.4 s	$0.006
gpt-5.6-sol	6	7.6 s	$0.004

Una risposta di Claude è costata circa sette volte una di GPT, soprattutto perché le risposte erano più lunghe (in media 622 token in uscita). Chatbox reinvia tutta la conversazione a ogni turno, ma su Claude in media 4.071 token per richiesta sono stati fatturati come lettura dalla cache invece che come input a prezzo pieno, e così le chat lunghe restano economiche. gpt-5.6-sol è stato il più economico ma il più lento a partire, perché ragiona prima di rispondere.

Errori incontrati da utenti reali di Chatbox

• 404 con corpo vuoto → un Percorso API senza /v1 nell'host, oppure Compatibile con Claude API senza /v1. Vedi le tabelle sopra.
• 400 This model is not supported on the Chat Completions endpoint → gpt-image-2.5 è stato scelto come modello di chat. I modelli di immagine funzionano solo nel Creatore di immagini.
• 403 Image generation is not enabled for this group → la chiave nel provider OpenAI non viene da un gruppo immagini.
• 404 model_not_found (is not supported by any configured account in this group) → il modello non è nel gruppo della tua chiave (un utente ha digitato gpt-5.2-pro, che non offriamo). Usa Recupera invece di digitare i nomi.
• Provider doesnt support image generation → il Creatore di immagini punta a un provider personalizzato. Usa il provider OpenAI integrato.

Altri client desktop: Cherry Studio con un'API personalizzata · URL base per Claude Code.

Inizia a usarlo

Nessun abbonamento, nessun minimo mensile, nessuna telefonata commerciale. Ricarica in USDT e spendi quello che usi — 1 USDT ti dà 2 crediti di saldo API.

Leggi l'avvio rapido da 30 secondi

Lingua: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

I prezzi di questa pagina sono compilati automaticamente dai dati di fatturazione reali. Le condizioni di terzi sono citate dalla loro documentazione.