FAQ

Domande frequenti su Synthorai.

Quali SDK supporta Synthorai?

L'SDK OpenAI (tramite /v1/chat/completions e /v1/responses) e l'SDK Anthropic (tramite /v1/messages). Imposta baseURL/base_url sul tuo gateway e usa la tua chiave API del gateway — nessun'altra modifica al codice.

Quale base URL devo incollare nel mio strumento?

Bastano due regole: gli strumenti in stile OpenAI (Codex, Cursor, Continue, Aider, LangChain ChatOpenAI, SDK OpenAI puro) vogliono l'origin CON /v1 in coda. Gli strumenti in stile Anthropic (Claude Code, SDK Anthropic, LangChain ChatAnthropic) vogliono l'origin SENZA /v1 — l'SDK aggiunge /v1/messages da solo. La pagina Compatibilità strumenti contiene la tabella completa. Vedi pagina →

Ho impostato le variabili d'ambiente ma il mio strumento si connette ancora al provider originale. Cosa mi è sfuggito?

Le nuove variabili d'ambiente valgono solo per le shell aperte DOPO la modifica del profilo. Apri un nuovo terminale, oppure esegui source ~/.zshrc / source ~/.bashrc in quello corrente. Verifica con echo $OPENAI_BASE_URL o echo $ANTHROPIC_BASE_URL.

Come faccio a sapere quali nomi di modello sono disponibili per me?

Esegui curl https://synthorai.io/v1/models -H "Authorization: Bearer YOUR_KEY", oppure visita Console → Prezzi modelli. Passa il valore della colonna id come parametro model nella richiesta — il gateway gestisce il routing automaticamente.

Posso usare l'SDK Anthropic con modelli non Claude?

No. /v1/messages instrada solo verso modelli Claude tramite canali Anthropic o Bedrock-Anthropic configurati. Per gli altri provider usa /v1/chat/completions, che funziona con ogni modello instradato.

Quale protocollo scegliere per un nuovo progetto?

Usa /v1/chat/completions per la massima compatibilità — funziona con ogni provider. Usa /v1/responses per tool use e reasoning OpenAI. Usa /v1/messages se ti stai standardizzando sull'SDK Anthropic.

Cosa succede quando la mia quota si esaurisce?

Le richieste restituiranno un codice di stato 403 con tipo di errore "quota_exceeded". Puoi ricaricare in Console → Limiti e fatturazione.

Come viene calcolato l'utilizzo?

L'utilizzo è misurato in token. I token di input e di output sono conteggiati separatamente e riportati nel campo usage di ogni risposta API.

Posso impostare quote per utente?

Sì. Gli amministratori possono configurare quote di token per utente da Console → Membri.

Le richieste vengono registrate?

Sì. Tutte le richieste vengono registrate con modello, token, latenza e stato. I log sono conservati per 30 giorni e disponibili in Console → Log.

Stai confrontando la spesa tra modelli? Il model price comparison elenca il prezzo per token di ogni modello instradabile, e il LLM API cost calculator converte i tuoi volumi di token in una stima di fattura mensile.