Get started ↗

Frequently asked questions

FAQ | Accounts, Top-ups, API Keys and Billing

Find answers about ZHUAN accounts, top-ups, API keys, billing and integration, then follow a guide to make your first request.

What is ZHUAN?

ZHUAN is an AI API access platform. You can configure the API endpoint and key in a compatible AI assistant or use them in your own application. One API key accesses available Claude, GPT and other models in the catalog, with usage-based billing, balance tracking and request history.

How do I register? Do I need an email address?

Register with a username and a password entered twice; no email address is required. Usernames contain 5–32 letters, digits or _ . - characters. Passwords contain 8–72 characters and support letters, digits and symbols. Choose a unique password that is difficult to guess.

Can I call models immediately after registering?

New accounts start with a zero balance. Top up online, wait for payment confirmation and credit, then select Generate API Key on the console's API keys page. If you have no balance, the generation flow directs you to top up.

What are the top-up limits and payment methods?

Your first top-up starts at USD 1. After it is credited, further top-ups start at USD 10. The maximum is USD 5,000 per order. Choose bank card or cryptocurrency and select a preset or custom amount. Your ZHUAN USD balance is credited by the order amount; currency conversion is shown at checkout.

What if my balance does not update immediately after payment?

Returning from checkout does not itself confirm payment. Check the order status on the top-up page and refresh; card processing and cryptocurrency network confirmations can take time. If a completed payment remains uncredited, contact Telegram support with the order details rather than paying the same order again.

How many API keys can one account create?

Each account has one effective API key at a time. Later top-ups increase the balance available to that account and key; you do not create another key for each top-up. Model API keys are not credentials for the website's management APIs.

What happens to my balance when a key is revoked?

Revocation invalidates the old key while preserving unused account balance. Top-ups made without an effective key are also credited to the account. With a positive balance, you can request a new, different key and update your applications. If reconciliation is in progress, wait for completion or contact support.

Which API endpoint and model ID should I use?

Set the OpenAI Python SDK base_url to https://key.zhuan.xyz/v1, or the Anthropic Python SDK base_url to https://key.zhuan.xyz/proxy. Copy the complete model ID from the price catalog rather than using a display nickname.

How are tokens and caching billed?

Prices are in USD per million tokens for input, output, cache reads and cache writes. Estimate a charge by multiplying each billable token category by its price, adding the results and dividing by one million. Do not count cached input again as regular input. Usage fields vary by model; the console request history is the billing reference.

Do price updates affect an existing key?

Public prices apply to newly created keys. Existing keys retain the pricing ratio set at creation, while base model prices can still change. Check your key's prices and charges in the console; current public prices should not be used to reconstruct past bills.

Where can I see my balance and request charges?

The console overview shows available balance and cumulative usage charges. Request history lists models, tokens, charges and duration; balance history records top-ups and administrator adjustments. Usage charges and top-up amounts are different metrics. Display precision and synchronization timing may also cause very small differences between totals.

Can I stream responses?

Compatible APIs support streaming. Use stream=True with the OpenAI SDK or messages.stream with the Anthropic SDK. Parameters and event formats depend on the selected model and API; validate a small request before integrating it into your application.

How do I handle 401, 402, 403 or 429 errors?

  • 401: Check that you use an effective ZHUAN key and the correct Authorization or x-api-key header.
  • 402: Check your available balance and retry after a top-up is confirmed.
  • 403: Check the account and key status; contact support with the request ID if access remains restricted.
  • 429: Reduce concurrency and request frequency, honor Retry-After when present, and use backoff.

Can I refund a top-up?

Top-ups are final and do not qualify for ordinary refunds. Unused balance is retained under the policy. Billing errors or duplicate charges can be reviewed; read the refund policy and terms before paying.

How do I contact ZHUAN support?

Message @zhuanxyzbot on Telegram with a description, time, model name and request ID. Support can help with accounts, payments and integration. Do not send passwords, complete API keys or card security codes.

Explore more