Skip to main content
Get Started

Base URL overview

The Base URL is the API endpoint for model calls. Pair it with an API Key from the same billing plan — a mismatch returns a 401 error. API Keys are region-specific.

Pay-as-you-go

Choose a domain that fits your use case:
  • DashScope domain (dashscope.aliyuncs.com): Legacy shared domain. Still available; migration to a workspace-dedicated domain is recommended.
  • Workspace-dedicated domain ([workspace-id].[region].maas.aliyuncs.com): Recommended for production. Higher throughput, lower latency, and workspace-level traffic isolation.
  • Trial domain (trial.[region].maas.aliyuncs.com): For testing and quick validation. Lower rate limits apply.

DashScope Domain

Accepts an API Key from any workspace in the same region.

Region

OpenAI-compatible

Anthropic-compatible

China (Beijing)

https://dashscope.aliyuncs.com/compatible-mode/v1

https://dashscope.aliyuncs.com/apps/anthropic

Singapore

https://dashscope-intl.aliyuncs.com/compatible-mode/v1

https://dashscope-intl.aliyuncs.com/apps/anthropic

US (Virginia)

https://dashscope-us.aliyuncs.com/compatible-mode/v1

https://dashscope-us.aliyuncs.com/apps/anthropic

China (Hong Kong)

https://cn-hongkong.dashscope.aliyuncs.com/compatible-mode/v1

https://cn-hongkong.dashscope.aliyuncs.com/apps/anthropic

To use the native DashScope API, replace the path after the domain in the URLs above with /api/v1. For example, the endpoint for the China (Beijing) region is https://dashscope.aliyuncs.com/api/v1.

Workspace-dedicated Domain

Requires an API Key that belongs to the target workspace.

Region

OpenAI-compatible

Anthropic-compatible

China (Beijing)

https:// {WorkspaceId} .cn-beijing.maas.aliyuncs.com/compatible-mode/v1

https:// {WorkspaceId} .cn-beijing.maas.aliyuncs.com/apps/anthropic

Singapore

https:// {WorkspaceId} .ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

https:// {WorkspaceId} .ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Japan (Tokyo)

https:// {WorkspaceId} .ap-northeast-1.maas.aliyuncs.com/compatible-mode/v1

https:// {WorkspaceId} .ap-northeast-1.maas.aliyuncs.com/apps/anthropic

Germany (Frankfurt)

https:// {WorkspaceId} .eu-central-1.maas.aliyuncs.com/compatible-mode/v1

https:// {WorkspaceId} .eu-central-1.maas.aliyuncs.com/apps/anthropic

US (Virginia)

https:// {WorkspaceId} .us-east-1.maas.aliyuncs.com/compatible-mode/v1

https:// {WorkspaceId} .us-east-1.maas.aliyuncs.com/apps/anthropic

China (Hong Kong)

https:// {WorkspaceId} .cn-hongkong.maas.aliyuncs.com/compatible-mode/v1

https:// {WorkspaceId} .cn-hongkong.maas.aliyuncs.com/apps/anthropic

To use the native DashScope API, replace the path after the domain in the URLs above with /api/v1. For example, the endpoint for the China (Beijing) region is https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1.

Trial Domain

Accepts an API Key from any workspace in the same region.

Region

OpenAI-compatible

Anthropic-compatible

China (Beijing)

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

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

Singapore

https://trial.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

https://trial.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

China (Hong Kong)

https://trial.cn-hongkong.maas.aliyuncs.com/compatible-mode/v1

https://trial.cn-hongkong.maas.aliyuncs.com/apps/anthropic

Token Plan

For interactive AI coding tools (Claude Code, Codex) only — not for backend services. Use the Token Plan dedicated API Key.

Region

OpenAI-compatible

Anthropic-compatible

Singapore

https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Coding Plan

For interactive AI coding tools (Claude Code, Codex) only — not for backend services. Use the Coding Plan dedicated API Key.

Region

OpenAI-compatible

Anthropic-compatible

Singapore

https://coding-intl.dashscope.aliyuncs.com/v1

https://coding-intl.dashscope.aliyuncs.com/apps/anthropic

References

Token Plan
Model Playground
  • Music generation
Statistics and Monitoring
Support