Perguntas frequentes
Perguntas frequentes sobre o Synthorai.
Quais SDKs o Synthorai suporta?
O SDK OpenAI (via /v1/chat/completions e /v1/responses) e o SDK Anthropic (via /v1/messages). Defina baseURL/base_url para o seu gateway e use a chave de API do gateway — sem outras alterações de código.
Qual base URL colo na minha ferramenta?
Duas regras cobrem tudo: ferramentas no estilo OpenAI (Codex, Cursor, Continue, Aider, LangChain ChatOpenAI, SDK OpenAI puro) querem a origem COM /v1 anexado. Ferramentas no estilo Anthropic (Claude Code, SDK Anthropic, LangChain ChatAnthropic) querem a origem SEM /v1 — o SDK adiciona /v1/messages por conta própria. A página de Compatibilidade de Ferramentas tem uma tabela completa. Ver página →
Configurei as variáveis de ambiente, mas minha ferramenta ainda se conecta ao provedor original. O que deixei passar?
As novas variáveis de ambiente só se aplicam a shells abertas DEPOIS de editar seu perfil. Abra um terminal novo, ou execute source ~/.zshrc / source ~/.bashrc no atual. Verifique com echo $OPENAI_BASE_URL ou echo $ANTHROPIC_BASE_URL.
Como sei quais nomes de modelos estão disponíveis para mim?
Execute curl https://synthorai.io/v1/models -H "Authorization: Bearer YOUR_KEY", ou acesse Console → Model Pricing. Passe o valor da coluna id como parâmetro model na sua requisição — o gateway lida com o roteamento automaticamente.
Posso usar o SDK Anthropic com modelos que não sejam Claude?
Não. /v1/messages só roteia para modelos Claude através de canais Anthropic ou Bedrock-Anthropic configurados. Para outros provedores use /v1/chat/completions, que funciona com todos os modelos roteados.
Qual protocolo devo escolher para um projeto novo?
Use /v1/chat/completions para máxima compatibilidade — funciona com todos os provedores. Use /v1/responses para uso de ferramentas e raciocínio da OpenAI. Use /v1/messages se você está padronizando no SDK Anthropic.
O que acontece quando minha cota se esgota?
As requisições retornarão um código de status 403 com o tipo de erro "quota_exceeded". Você pode recarregar em Console → Limits & Billing.
Como o uso é calculado?
O uso é monitorado em tokens. Os tokens de entrada e saída são contados separadamente e informados no campo usage de cada resposta da API.
Posso definir cotas por usuário?
Sim. Os administradores podem configurar cotas de tokens por usuário em Console → Members.
As requisições são registradas?
Sim. Todas as requisições são registradas com modelo, tokens, latência e status. Os logs são retidos por 30 dias e estão disponíveis em Console → Logs.
Comparando gastos entre modelos? A model price comparison lista o preço por token de cada modelo roteável, e a LLM API cost calculator converte seus volumes de tokens em uma estimativa de fatura mensal.