FAQ

Questions fréquemment posées sur Synthorai.

Quels SDK Synthorai prend-il en charge ?

Le SDK OpenAI (via /v1/chat/completions et /v1/responses) et le SDK Anthropic (via /v1/messages). Définissez baseURL/base_url sur votre passerelle et utilisez votre clé API de passerelle — aucune autre modification de code.

Quelle base URL dois-je coller dans mon outil ?

Deux règles couvrent tout : les outils de style OpenAI (Codex, Cursor, Continue, Aider, LangChain ChatOpenAI, SDK OpenAI brut) veulent l'origine AVEC /v1 ajouté. Les outils de style Anthropic (Claude Code, SDK Anthropic, LangChain ChatAnthropic) veulent l'origine SANS /v1 — le SDK ajoute /v1/messages lui-même. La page Compatibilité des outils contient un tableau complet. Voir la page →

J'ai défini les variables d'environnement mais mon outil se connecte toujours au fournisseur d'origine. Qu'ai-je oublié ?

Les nouvelles variables d'environnement ne s'appliquent qu'aux shells ouverts APRÈS la modification de votre profil. Ouvrez un nouveau terminal, ou exécutez source ~/.zshrc / source ~/.bashrc dans le terminal actuel. Vérifiez avec echo $OPENAI_BASE_URL ou echo $ANTHROPIC_BASE_URL.

Comment savoir quels noms de modèles sont disponibles pour moi ?

Exécutez curl https://synthorai.io/v1/models -H "Authorization: Bearer YOUR_KEY", ou consultez Console → Model Pricing. Passez la valeur de la colonne id comme paramètre model dans votre requête — la passerelle gère le routage automatiquement.

Puis-je utiliser le SDK Anthropic avec des modèles non-Claude ?

Non. /v1/messages ne route que vers les modèles Claude via des canaux Anthropic ou Bedrock-Anthropic configurés. Pour les autres fournisseurs, utilisez /v1/chat/completions, qui fonctionne avec tous les modèles routés.

Quel protocole choisir pour un nouveau projet ?

Utilisez /v1/chat/completions pour une compatibilité maximale — il fonctionne avec tous les fournisseurs. Utilisez /v1/responses pour l'utilisation d'outils et le raisonnement OpenAI. Utilisez /v1/messages si vous vous standardisez sur le SDK Anthropic.

Que se passe-t-il lorsque mon quota est épuisé ?

Les requêtes renverront un code de statut 403 avec le type d'erreur « quota_exceeded ». Vous pouvez recharger dans Console → Limits & Billing.

Comment l'utilisation est-elle calculée ?

L'utilisation est suivie en tokens. Les tokens d'entrée et de sortie sont comptés séparément et indiqués dans le champ usage de chaque réponse API.

Puis-je définir des quotas par utilisateur ?

Oui. Les administrateurs peuvent configurer des quotas de tokens par utilisateur depuis Console → Members.

Les requêtes sont-elles journalisées ?

Oui. Toutes les requêtes sont journalisées avec le modèle, les tokens, la latence et le statut. Les journaux sont conservés 30 jours et disponibles dans Console → Logs.

Vous comparez les dépenses entre modèles ? Le model price comparison liste le prix par token de chaque modèle routable, et le LLM API cost calculator convertit vos volumes de tokens en estimation de facture mensuelle.