Quick start
Get started with Token Plan Personal Edition in three steps: choose a plan, obtain an API Key, and configure your AI tools.
Step 1: Subscribe to Token Plan Personal Edition
Visit the Token Plan Personal Edition purchase page, select a plan tier and subscription period, and complete the subscription.
Purchase notes:
-
RAM user authorization: Before a RAM user can use Token Plan, the primary account must complete the following authorization:
- In the RAM console, grant the RAM user the
AliyunTokenPlanReadOnlyAccess(read-only) orAliyunTokenPlanFullAccess(full access) system policy, and also grant theAliyunBSSReadOnlyAccesssystem policy. - In the Model Studio console Account Management page, assign the Administrator or Subscribe Plan role to the RAM user.
- In the RAM console, grant the RAM user the
Step 2: Obtain your API Key and Base URL
- API Key: After subscribing, generate an API Key on the My Subscription page in the Token Plan console. The API Key is displayed in full only once when generated — copy and securely store it immediately.
- Base URL: Select the Base URL that corresponds to the protocol supported by your AI tool.
Protocol | Base URL |
|---|---|
OpenAI-compatible |
|
Anthropic-compatible |
|
ImportantToken Plan API Keys start with sk-sp-, which differs from the standard Model Studio API Keys (starting with sk-). The two types cannot be used interchangeably. The API Keys and Base URLs for Token Plan, Coding Plan, and pay-as-you-go are completely isolated and must be used in matching pairs.
Step 3: Configure your AI tools
Enter the API Key and Base URL into your AI tool to start using the service.
Open-source, self-hosted personal AI assistant | Open-source AI agent framework with built-in self-learning loop | AI terminal coding assistant with natural language programming |
Open-source AI coding agent tool | AI-native code editor | Command-line coding tool by OpenAI |
Open-source command-line AI coding tool | Open-source personal AI assistant for local and cloud deployment | Multi-model desktop client |
Cross-platform AI desktop client | VS Code extension for intelligent code completion and debugging | Agentic coding platform for real-world software development |
Alibaba Cloud intelligent coding assistant with standalone IDE | Lightweight, high-performance command-line coding tool | Open-source AI agent framework by DeepSeek |
| More Tools Other coding tools |
Optional: Integrate multimodal generation models
Token Plan Personal Edition supports multimodal generation models (wan2.7-image, happyhorse-1.1-t2v, etc.). Multimodal generation models are not compatible with the standard text generation endpoint (/api/v1/services/aigc/text-generation/generation) or the OpenAI-compatible endpoint (/compatible-mode/v1/chat/completions). You must call them through their dedicated endpoints. For example, video generation models such as happyhorse-1.1-t2v use the /api/v1/services/aigc/video-generation/video-synthesis endpoint. Integrate them through the Skill or extension mechanism of your AI tool. For details, see Integrate multimodal generation models.
FAQ
What should I do if calling a multimodal generation model returns a url error or a model_not_supported error?Multimodal generation models do not support the standard text generation endpoint or the OpenAI-compatible endpoint. Calling them through the wrong endpoint returns an InvalidParameter error with the message "url error", or a model_not_supported error. Switch to the dedicated endpoint: video generation models use /api/v1/services/aigc/video-generation/video-synthesis, and image generation models use /api/v1/services/aigc/image-generation/generation.
Optional: Integrate Harness tools
Some Qwen models (qwen3.7 and qwen3.8 series) have built-in Harness tools that extend capabilities such as web search, text-to-image search, reverse image search, web scraping, and code interpreter during conversations. Harness tools can only be invoked through the Responses API, and Credits are deducted based on the number of successful invocations. For details, see Integrate Harness tools.
ImportantHarness tools are built-in tools of the Responses API and cannot be invoked through the Chat Completions API. To use Harness tools, ensure that your AI tool connects through the Responses API.