Quick start

Updated at:

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:

    1. In the RAM console, grant the RAM user the AliyunTokenPlanReadOnlyAccess (read-only) or AliyunTokenPlanFullAccess (full access) system policy, and also grant the AliyunBSSReadOnlyAccess system policy.
    2. In the Model Studio console Account Management page, assign the Administrator or Subscribe Plan role to the RAM user.

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

https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

Anthropic-compatible

https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic

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.

OpenClaw

Open-source, self-hosted personal AI assistant

Hermes Agent

Open-source AI agent framework with built-in self-learning loop

Claude Code

AI terminal coding assistant with natural language programming

OpenCode

Open-source AI coding agent tool

Cursor

AI-native code editor

Codex

Command-line coding tool by OpenAI

Qwen Code

Open-source command-line AI coding tool

QwenPaw

Open-source personal AI assistant for local and cloud deployment

Cherry Studio

Multi-model desktop client

Chatbox

Cross-platform AI desktop client

Cline

VS Code extension for intelligent code completion and debugging

Qoder

Agentic coding platform for real-world software development

Lingma

Alibaba Cloud intelligent coding assistant with standalone IDE

Kilo CLI

Lightweight, high-performance command-line coding tool

DeepSeek Harness

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.