Preguntas frecuentes
Preguntas frecuentes sobre Synthorai.
¿Qué SDK admite Synthorai?
El SDK de OpenAI (vía /v1/chat/completions y /v1/responses) y el SDK de Anthropic (vía /v1/messages). Establece baseURL/base_url en tu gateway y usa tu clave API del gateway — sin otros cambios de código.
¿Qué base URL pego en mi herramienta?
Dos reglas lo cubren todo: las herramientas de estilo OpenAI (Codex, Cursor, Continue, Aider, LangChain ChatOpenAI, SDK de OpenAI sin procesar) quieren el origen CON /v1 añadido. Las herramientas de estilo Anthropic (Claude Code, SDK de Anthropic, LangChain ChatAnthropic) quieren el origen SIN /v1 — el SDK añade /v1/messages por sí mismo. La página de Compatibilidad de herramientas tiene una tabla completa. Ver página →
Configuré las variables de entorno pero mi herramienta sigue conectándose al proveedor original. ¿Qué se me pasó?
Las nuevas variables de entorno solo se aplican a las shells abiertas DESPUÉS de editar tu perfil. Abre una terminal nueva, o ejecuta source ~/.zshrc / source ~/.bashrc en la actual. Verifica con echo $OPENAI_BASE_URL o echo $ANTHROPIC_BASE_URL.
¿Cómo sé qué nombres de modelos están disponibles para mí?
Ejecuta curl https://synthorai.io/v1/models -H "Authorization: Bearer YOUR_KEY", o visita Console → Model Pricing. Pasa el valor de la columna id como parámetro model en tu solicitud — el gateway gestiona el enrutamiento automáticamente.
¿Puedo usar el SDK de Anthropic con modelos que no sean Claude?
No. /v1/messages solo enruta a modelos Claude a través de canales Anthropic o Bedrock-Anthropic configurados. Para otros proveedores usa /v1/chat/completions, que funciona con todos los modelos enrutados.
¿Qué protocolo debo elegir para un proyecto nuevo?
Usa /v1/chat/completions para máxima compatibilidad — funciona con todos los proveedores. Usa /v1/responses para el uso de herramientas y razonamiento de OpenAI. Usa /v1/messages si te estás estandarizando en el SDK de Anthropic.
¿Qué sucede cuando se agota mi cuota?
Las solicitudes devolverán un código de estado 403 con el tipo de error «quota_exceeded». Puedes recargar en Console → Limits & Billing.
¿Cómo se calcula el uso?
El uso se rastrea en tokens. Los tokens de entrada y salida se cuentan por separado y se informan en el campo usage de cada respuesta de la API.
¿Puedo establecer cuotas por usuario?
Sí. Los administradores pueden configurar cuotas de tokens por usuario desde Console → Members.
¿Se registran las solicitudes?
Sí. Todas las solicitudes se registran con modelo, tokens, latencia y estado. Los registros se conservan durante 30 días y están disponibles en Console → Logs.
¿Comparas el gasto entre modelos? La model price comparison enumera el precio por token de cada modelo enrutable, y la LLM API cost calculator convierte tus volúmenes de tokens en una estimación de factura mensual.