Documentation Index
Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
Use this file to discover all available pages before exploring further.
What is a token (API KEY)
A token is the API KEY you use to call API易, starting withsk-. It is the credential for your identity and permissions. Its main roles include:
Authentication
Every API call must carry a token to verify your identity and account.
Quota & permission control
Set a dedicated quota, expiry date, allowed models, and groups per token.
Usage statistics
Track each token’s spend, remaining quota, and call logs independently.
Flexible allocation
Create separate tokens for different projects or team members.
After registration, the system automatically generates a default token that works out of the box. You can also create additional tokens as needed.
How to create a token
Open the Token page
Open the “Token” page from the top navigation: https://api.apiyi.com/token
Fill in token details
Set the token name, quota (unlimited optional), expiry (never-expire optional), billing mode, and group (see below).
Editing a token & viewing code examples
Click the management menu (wrench icon) in the “Actions” column to expand all operations:
| Action | Description |
|---|---|
| Disable token | Temporarily disable the token; calls will be rejected |
| Edit token | Change name, quota, expiry, billing mode, group, etc. |
| Request example | View code examples — ready-to-run call code in multiple languages (curl, Python, etc.) for this token |
| Token logs | View this token’s call records |
| Share token / One-click setup | Quickly share or integrate with third-party tools |
“Request example” is the code example entry point. It generates runnable call code with the current token pre-filled, so you don’t have to assemble the KEY and endpoint manually — ideal for quick testing and integration.
What is a group
A group is a “resource channel” you can choose for a token. Different groups map to different upstream resources, available model ranges, and billing multipliers, and are open for users to choose. In short: the same model may be served by multiple upstream channels, and the group lets you choose which channel to use. Different models may require different groups, so picking the right group ensures the call works and gets the corresponding discount.In the vast majority of cases, the default group (Default) is all you need — it has full model coverage, including text models, the NanoBanana series, Veo 3.1, and most others.
Default group & fallback groups
A single token can have up to 3 groups: 1 default group + 2 fallback groups.Default group (primary)
The group the token uses first; covers most models. Every token must have 1 default group.
Fallback groups (backup)
Backup channels that activate automatically when the default group cannot serve a request. Up to 2, improving call success rate.
- Select group: sets the default (primary) group,
Defaultby default - Fallback group: add 1–2 backup groups that take over when the primary is unavailable
Different models need different groups
The default group covers most models, but some models (especially video models) require a dedicated group:| Model / scenario | Group to choose |
|---|---|
| Text, multimodal, NanoBanana, Veo 3.1, and most models | Default |
| Sora 2 official video | Sora2Official |
| Alibaba Wan video series | Wan |
Group overview
Below are the groups and descriptions provided by the system (the console display is authoritative):
The “Group multiplier” column is a relative value priced in RMB — it is not a direct USD discount ratio, so there’s no need to over-analyze it. Just pick the group that matches your model. To understand multipliers and price conversion, see What is a model’s multiplier?.
Related docs
Token billing modes
Understand the difference between pay-per-usage and pay-per-call modes.
Token model whitelist
How to limit the models a single token can use.
Model multiplier
Understand multiplier meaning and price calculation.
Call logs
View call records and spend details per token.