Fix Token Plan issues fast
What is the difference between Token Plan and Coding Plan?
| Token Plan | Coding Plan | |
|---|---|---|
| Use cases | Day-to-day work for solo founders, teams, and enterprises | Individual development scenarios |
| Supported models | Text generation and image generation models | Text generation models |
| Billing method | Credits deducted based on token consumption | Billed per model call |
| Usage frequency | Unlimited | Quota per 5 hours / per week |
| API Key and Base URL | Get from the Token Plan page | Get from the Coding Plan page |
| Peak-time performance | Multi-tenant isolation | Requests may queue during peak hours |
| Data security | Your data is not used to train models | User data authorization required |
Important resources
- Token Plan page: Manage your subscription and view usage on the Token Plan page
- API Keys page: View and reset your API keys on the API Keys page
- Supported models: See the full list of models
- Setup guides: Configuration instructions for Claude Code, OpenCode, OpenClaw, and more
Start here: 60-second diagnosis
If your tool is not working and you see errors like 401, 403, 404, invalid access token, invalid api-key, quota exceeded, or connection failures, check these first:
- API key: Must be the Token Plan dedicated key, not a pay-as-you-go
sk-key or a Coding Plansk-sp-key - Base URL: Must contain
token-plan, notdashscope-intlorcoding - Authentication header: Must use
Authorization: Bearer, notx-api-key - Subscription status: Check whether your subscription is active and credits are not depleted
- Updated config: Restart the tool after updating the API key or base URL
Text generation
Which text generation models are supported?
Token Plan supports the following text generation models:
- qwen3.6-plus
- glm-5
- MiniMax-M2.5
- deepseek-v3.2
deepseek-v3.2 supports only the OpenAI-compatible protocol. It cannot be called through the Anthropic-compatible endpoint.
Common errors and solutions
| Error message | Possible causes | Solution |
|---|---|---|
| InvalidApiKey: No API-key provided. | 1. No API key configured. 2. The tool uses x-api-key header instead of Authorization: Bearer. | 1. Go to the Token Plan page, copy your dedicated API key, and configure it in your tool. 2. Change the authentication method to Authorization: Bearer. See Set up AI tools for details. |
| InvalidApiKey: Invalid API-key provided. | 1. You used a Qwen Cloud pay-as-you-go key (sk-xxx) or a Coding Plan key (sk-sp-xxx). 2. Your Token Plan subscription has expired. 3. The API key is incomplete or contains spaces. | 1. Go to the Token Plan page and use your dedicated API key. Ensure you copy the entire key without any spaces. 2. Confirm that your subscription has not expired. 3. If the error persists, reset the API key in the console and update your tools with the new key. |
| model 'xxx' not found or not supported | 1. The model name is misspelled or uses the wrong case. 2. The model does not support the protocol you are using. | 1. Ensure the model name is case-sensitive and matches the model ID listed in Supported models. 2. deepseek-v3.2 must be called through the OpenAI-compatible endpoint. |
| invalid access token or token expired | You used the base URL for the Coding Plan or another plan. | Use the correct Token Plan base URL. OpenAI compatible: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Anthropic compatible: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic. |
| Incorrect API key provided | You used the general Qwen Cloud base URL (dashscope-intl.aliyuncs.com). | Use the correct Token Plan base URL. OpenAI compatible: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Anthropic compatible: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic. |
| Range of input length should be [1, xxx] | Your input (including conversation history and code context) exceeds the model's maximum context length. | Start a new session or shorten the context. You can also switch to a model with a larger context window. |
| Connection error | The base URL domain is misspelled, or you have a network connection issue. | Check the spelling of the base URL domain and your network connection. |
Image generation
Which image generation models are supported?
Token Plan supports the following image generation models:
- qwen-image-2.0
- qwen-image-2.0-pro
- wan2.7-image
- wan2.7-image-pro
Can I use image models in coding tools?
Image generation models use separate APIs and cannot be called directly through the text model's base URL. You must integrate them through your tool's skill or extension mechanism. For configuration steps, see the image generation model integration section in each tool's setup guide.
Common errors & fixes
Which API key and base URL should I use?
Use a Token Plan dedicated key and a Token Plan base URL:
- API key: Get it from the Token Plan page
- OpenAI compatible:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Anthropic compatible:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
dashscope-intl URLs and Coding Plan coding-intl URLs do not work with Token Plan keys.
I got 401 or 403. Is my API key invalid?
If you see 401 invalid access token, InvalidApiKey, or 403 invalid api-key, the problem is usually a wrong key type, an expired subscription, a malformed key, or a key and URL mismatch.
Check these points:
- Confirm the key is your Token Plan dedicated key
- Re-copy the key to remove hidden spaces or line breaks
- Confirm your subscription is active on the Token Plan page
- Make sure the base URL contains
token-plan
401 invalid access tokenmeans wrong key type, expired subscription, or malformed key403 invalid api-keymeans you are using a Token Plan key with a non-Token Plan URLIncorrect API key providedmeans you are using a Token Plan key with the generaldashscope-intlURL
Why do I get 404 or connection errors?
If you get 404 status code (no body), endpoint not found, or connection errors, the base URL path is usually wrong for your tool.
Use the correct path for your protocol:
- Anthropic-compatible tools use
/apps/anthropic - OpenAI-compatible tools use
/compatible-mode/v1
token-plan.ap-southeast-1.maas.aliyuncs.com.
Why is my model "not supported"?
If you get model 'xxx' is not supported or model 'xxx' not found, the model ID is usually incorrect, case-sensitive, or copied with extra spaces.
Check these points:
- Use the exact model name from Supported models
- Remove any leading or trailing spaces
- Verify capitalization exactly as documented
- If using deepseek-v3.2, confirm you are using the OpenAI-compatible endpoint, not the Anthropic-compatible endpoint
How to handle input length limits?
If you get 400 InvalidParameter: Range of input length should be [1, xxx], your context or request exceeds model limits.
Try these fixes:
- Create a new session
- Switch to a model with a larger context window
- In your tool, configure context length limits if available
What should I do if I see data_inspection_failed?
If you see data_inspection_failed, refer to Troubleshooting data inspection errors.
Product features
Can I mix Token Plan, Coding Plan, and pay-as-you-go keys?
No. The API keys and base URLs for Token Plan, Coding Plan, and Qwen Cloud pay-as-you-go are not interchangeable. Do not mix them. Using an incorrect API key will not deduct credits from your Token Plan quota.
Can I use one subscription across multiple tools?
Yes. You can use the same API key in all compatible AI tools, and all usage draws from the same quota.
Are there usage restrictions?
The service is for interactive use in compatible AI programming and agent tools only. It cannot be used for automated scripts or application backends. Violating these terms may result in subscription suspension or revocation of your API key.
Are the models full-featured or quantized?
All supported models in Token Plan are full-featured, unquantized versions.
How do I reset or manage my API key?
Use the Reset button on the API Keys page to reset your key.
Keep these rules in mind:
- After reset, update the key in all tools
- If you resubscribe after expiration, the key changes
- Token Plan supports one key per subscription
Billing and quota
How are credits deducted?
Credit consumption is calculated based on the input, cached, and output tokens in each request. The system first deducts credits from your seat quota. After the seat quota is depleted, credits are deducted from the shared usage package. If all credits are used, the service is suspended until the next billing cycle or until you purchase a shared usage package to add more credits.
What happens when my quota runs out?
Once your seat quota is depleted, the system automatically begins deducting from the shared usage package. If you run out of credits entirely, the service is suspended. You can resume the service in one of the following ways:
- Upgrade to a higher-tier plan
- Purchase a shared usage package to add more credits
- Wait for your quota to automatically reset at the start of the next billing cycle