汕拓智算

简体中文

English

简体中文

English

主题

常见问题 ​

下面是接入与计费中最常见的问题。更多细节见计费、鉴权与快速开始。

充值后余额没有更新怎么办? ​

充值与消费在同一本账里对账,余额通常会在对账后更新。如果稍等之后仍未更新,请带上充值的订单号或 trace id 提交工单,我们会据此核对那笔记录。控制台的用量台账可以查到对应的订单与 trace id。

失败或超时的请求会计费吗? ​

不会。失败和超时的请求不计费。只有成功的调用才会按所调用模型的官方定价结算,详见计费。

如何在 Cursor / Cline / Claude Code 等工具里配置? ​

把工具的 Base URL 和 API Key 指向 SwatowAPI 即可,工具原生的使用方式不变:

  • Base URL:按你 Key 分组的平台选择。OpenAI 兼容面用 https://swato.ai/v1;Anthropic 兼容面用 https://swato.ai(客户端会追加 /v1/messages);Gemini 兼容面用 https://swato.ai/v1beta。
  • API Key:在控制台签发的 sk-...。

配好这两项后,Cursor、Cline、Claude Code、Codex、Gemini CLI 等工具按原本的方式使用即可。完整步骤见快速开始。

API 调用日志保留多久? ​

每次调用的日志与 trace 都可以在控制台查看(按调用记录,带 trace id)。具体的保留时长以你的套餐为准,请在控制台查看,本页不给出固定的保留期。

我应该用哪套协议(OpenAI / Anthropic / Gemini)? ​

取决于你 Key 分组的平台以及你所用的工具:

  • 分组平台为 OpenAI 的 Key → 走 OpenAI 兼容面(如 /v1/chat/completions)。
  • 分组平台为 Anthropic 的 Key → 走 Anthropic 兼容面(如 /v1/messages)。
  • 分组平台为 Google 的 Key → 走 Gemini 兼容面(/v1beta/...)。

同一个端点会按你所用 Key 的分组平台自动选路;跨平台调用会得到 404。如果你的工具是 Anthropic SDK,就用 Anthropic 平台的 Key,以此类推。详见鉴权。

国内和海外的 Base URL 一样吗? ​

路径结构完全一致,只是来源(origin)不同:

  • 海外用户使用 https://swato.ai(OpenAI 面 https://swato.ai/v1,Gemini 面 https://swato.ai/v1beta)。
  • 国内(汕拓智算)用户使用国内控制台自身的来源作为 Base URL。

把示例里的 https://swato.ai 换成你对应的来源即可,其余路径不变。