Frequently Asked Questions
Answers to common questions about the WOX API
Frequently Asked Questions
Common questions about WOX API accounts, models, billing, and integration
WOX is an AI API aggregation and gateway platform. Its unified API provides access to the text, image, audio, embedding, reranking, and other model capabilities currently available on the platform.
See the Models and Pricing page. Models, prices, supported parameters, and availability may change as the platform and upstream providers are updated, so this documentation does not maintain a fixed list.
Any free models, promotional credits, or campaign benefits are determined by the current information shown on the platform. Calls that are not explicitly marked as free deduct funds from your wallet balance or subscription quota according to your account's billing preference and the system's settlement rules.
After signing in, create a key on the API Keys page. Each API Key can have its own quota, expiration time, model, group, and IP restrictions.
The examples use https://api.wox.lol/v1 by default. WOX may also provide other routes; refer to the platform for currently available addresses and route details.
You can review request records, settlement results, and your account balance on the Usage page and related billing pages. Displayed data may be briefly delayed; the system's settlement records are authoritative.
Common causes include model generation time, long input, network latency, platform load, or the status of an upstream provider. Review the request logs, shorten the input, switch to another available route or model, and configure appropriate timeout and retry behavior.
Immediately disable or delete the old key on the API Keys page, create a replacement, and review your usage logs. Never expose a key in client-side code, public repositories, or logs.
A 429 response means that the request triggered a platform or upstream rate limit. If the response includes Retry-After, wait for the specified interval. Otherwise, use exponential backoff and limit the number of automatic retries.
Use the support or community channels currently shown on the WOX platform. When reporting an issue, include the request time, request ID, endpoint, and error details. Do not send your complete API Key.
See the Chinese community FAQ document. External documentation may change; official rules and API responses on the WOX platform take precedence.