常见问题

关于 Synthorai 的常见问题。

Synthorai 支持哪些 SDK？

OpenAI SDK（通过 /v1/chat/completions 和 /v1/responses）和 Anthropic SDK（通过 /v1/messages）。将 baseURL/base_url 设置为你的网关并使用你的网关 API key —— 无需任何其他代码改动。

我应该把哪个 base URL 粘贴到我的工具里？

两条规则即可覆盖：OpenAI 风格的工具（Codex、Cursor、Continue、Aider、LangChain ChatOpenAI、原生 OpenAI SDK）需要在 origin 后附加 /v1。Anthropic 风格的工具（Claude Code、Anthropic SDK、LangChain ChatAnthropic）需要不带 /v1 的 origin —— SDK 会自行添加 /v1/messages。Tool Compatibility 页面提供了完整的对照表。 查看页面 →

我设置了环境变量，但工具仍然连接到原始供应商。我漏了什么？

新的环境变量只对你编辑配置文件之后打开的 shell 生效。请打开一个新终端，或在当前终端运行 source ~/.zshrc / source ~/.bashrc。可用 echo $OPENAI_BASE_URL 或 echo $ANTHROPIC_BASE_URL 验证。

我如何知道有哪些模型名称可供我使用？

运行 curl https://synthorai.io/v1/models -H "Authorization: Bearer YOUR_KEY"，或访问 Console → Model Pricing。将 id 列的值作为请求中的 model 参数传入 —— 网关会自动处理路由。

我可以将 Anthropic SDK 用于非 Claude 模型吗？

不能。/v1/messages 只会通过已配置的 Anthropic 或 Bedrock-Anthropic 通道路由到 Claude 模型。对于其他供应商，请使用 /v1/chat/completions，它适用于所有已路由的模型。

新项目应该选择哪种协议？

为获得最大兼容性，请使用 /v1/chat/completions —— 它适用于所有供应商。需要 OpenAI 工具调用和推理时，使用 /v1/responses。如果你统一采用 Anthropic SDK，则使用 /v1/messages。

配额用尽后会发生什么？

请求将返回 403 状态码，错误类型为 "quota_exceeded"。你可以在 Console → Limits & Billing 中充值。

用量是如何计算的？

用量以 token 计量。输入和输出 token 分别计数，并在每个 API 响应的 usage 字段中报告。

我可以设置每个用户的配额吗？

可以。管理员可在 Console → Members 中配置每个用户的 token 配额。

请求会被记录吗？

是。所有请求都会记录模型、token、延迟和状态。日志保留 30 天，可在 Console → Logs 中查看。

想在不同模型之间比较支出?model price comparison 列出每个可路由模型的按 token 价格,而 LLM API cost calculator 能把你的 token 用量换算成每月账单估算。