FAQ

The most common questions about integration and billing. For more detail, see Billing, Authentication, and Quickstart.

What if my balance does not update after payment?

Top-ups and spend reconcile in one ledger, and your balance usually updates once reconciled. If it still does not update after a short wait, open a support ticket with the order id or trace id from the payment, and we will check that record against it. The usage ledger in the console shows the corresponding order and trace id.

Are failed or timed-out requests billed?

No. Failed and timed-out requests are not billed. Only successful calls are charged, against the official pricing of the model you call. See Billing.

How do I configure Cursor, Cline, Claude Code, or similar tools?

Point the tool's Base URL and API key at SwatowAPI. The tool's native workflow is unchanged:

• Base URL: pick it by your key's group platform. OpenAI-compatible uses https://swato.ai/v1; Anthropic-compatible uses https://swato.ai (the client appends /v1/messages); Gemini-compatible uses https://swato.ai/v1beta.
• API key: the sk-... issued in the console.

With those two set, Cursor, Cline, Claude Code, Codex, Gemini CLI, and similar tools work the way they normally do. See Quickstart for the full steps.

How long are API call logs retained?

Logs and traces for each call are available in the console (per-call records, each with a trace id). The exact retention period depends on your plan, so check the console; this page does not state a fixed retention period.

Which protocol should I use (OpenAI / Anthropic / Gemini)?

It depends on your key's group platform and the tool you use:

• A key whose group platform is OpenAI uses the OpenAI-compatible surface (for example /v1/chat/completions).
• A key whose group platform is Anthropic uses the Anthropic-compatible surface (for example /v1/messages).
• A key whose group platform is Google uses the Gemini-compatible surface (/v1beta/...).

The same endpoint auto-routes by your key's group platform; a cross-platform call returns 404. If your tool is the Anthropic SDK, use an Anthropic-platform key, and so on. See Authentication.

Are the domestic and overseas base URLs the same?

The path structure is identical; only the origin differs:

• Overseas users use https://swato.ai (OpenAI surface https://swato.ai/v1, Gemini surface https://swato.ai/v1beta).
• Domestic (汕拓智算) users use the domestic console's own origin as the base URL.

Swap https://swato.ai in the examples for your matching origin; the rest of the path stays the same.