Generic Integration Guide

Connect third-party tools that support the OpenAI or Anthropic API to Alibaba Cloud Model Studio.

Quick Start

1. 1

   Get an API key

   Get the API key for your billing plan:

   • Token Plan Personal Edition: Create or view API Key
   • Token Plan Team Edition: Assign a seat and get the API Key
   • Pay-as-you-go: Model Studio API key
   • Coding Plan: Coding Plan API key
2. 2

   Select the protocol and Base URL

   Select the protocol in the tool's custom model settings and enter the corresponding Base URL. For the OpenAI protocol, use the compatible-mode/v1 or /v1 address. For the Anthropic protocol, use the /apps/anthropic address.

   Token Plan

   • OpenAI Base URL: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
   • Anthropic Base URL: https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic

   Pay-as-you-go

   Replace {WorkspaceId} with your actual Workspace ID.

   • OpenAI Base URL: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
   • Anthropic Base URL: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic

   Coding Plan

   • OpenAI Base URL: https://coding.dashscope.aliyuncs.com/v1
   • Anthropic Base URL: https://coding.dashscope.aliyuncs.com/apps/anthropic
3. 3

   Enter the model

   Enter the model ID for your billing plan:

   • Token Plan: a text generation model supported by Personal Edition or Team Edition
   • Pay-as-you-go: for example, qwen3.8-max or qwen3.8-flash
   • Coding Plan: a supported text generation model
4. 4

   Verify

   Send a test message. A model reply confirms the connection.

Unsupported tool types

Token Plan Personal Edition, Token Plan (Team Edition), and Coding Plan support only AI programming tools and OpenClaw-type agents. The following tools are not supported:

• Workflow and automation platforms: Dify, n8n, Coze, etc.
• API testing tools: Postman, Insomnia, etc.
• Custom applications: automated scripts, application backends calling the API directly, etc.

Using a plan API key for calls outside the permitted scope may be considered a violation or abuse, and may result in subscription suspension or API key ban.