Frequently Asked Questions (FAQ)

A collection of common questions and troubleshooting solutions when using Aitok.

Q1: I have sufficient account balance. Why do I see a 402 Payment Required error?

This typically occurs for one of two reasons:

AI Key Spending Cap Reached: You can assign individual spending limits to each AI Key. If the cumulative consumption on that specific key hits its limit, subsequent requests using it will be declined—even if your general account balance has plenty of funds remaining.
- Fix: Navigate to AI Keys (/hub/ai-key), edit the key, and increase its spending cap or reset the cycle.
Instant High-Concurrency Surge: A sudden burst of massive parallel requests might trigger temporary circuit-breaker limits to prevent overdraft. Wait a few moments and retry.

Q2: Why is the client returning 401 Unauthorized?

Check Key Format: Verify that the full key string (beginning with sk-...) was copied completely without accidental trailing whitespace or newline characters.
Key Status: Confirm in the console that the key has not been toggled to "Disabled" or deleted.
Aitok Hub Local Gateway Mode: If pointing to http://127.0.0.1:8309, make sure Aitok Hub is currently authenticated and running.

Q3: Why do I experience timeouts or connection resets in Cursor or Claude Code?

Direct connections can suffer from regional ISP routing latency or TLS handshake delays.

Recommended Solution: Install and run Aitok Hub.
Aitok Hub automatically optimizes route tunnels. Simply configure your tool's API base URL to http://127.0.0.1:8309 for a smooth, reliable connection.

Q4: Which API protocols does Aitok support? Do I need to modify my existing code?

Aitok employs a transparent pass-through mechanism directly to upstream model providers, meaning we support all native formats and protocols provided by upstream vendors.

Native Pass-Through: Aitok does not enforce restrictive intermediate translations. Whether a provider utilizes standard industry structures or proprietary request schemas, Aitok forwards payloads transparently.
Explicit Format Visibility: Under the Compute & Models catalog in your console, we explicitly display the native protocol format accepted by each respective provider.
You can submit requests in the vendor's native specifications directly—your existing tools, SDKs, and codebases work out of the box with zero compromises.

Q5: Does my deposited balance expire? How do I get an invoice?

Permanent Validity: Funds deposited in Aitok do not expire. They remain ready for use whenever you need them.
Tax Invoices / Receipts: Navigate to Billing & Payments -> Invoices (/hub/recharge/receipt), enter your company or personal tax registration details, and the electronic PDF invoice will be generated and emailed to you.