Alibaba Cloud Model Studio:Choose region and deployment mode

The region for the model service is the physical location of its endpoints. When selecting a region, consider the following factors:

• Access latency: Physical distance is the primary factor affecting response time. Choose a region that is geographically close to you and your end users to minimize network latency.

• Compliance requirements: Select a region that meets your data residency requirements. Your deployment must comply with local laws and regulations.

• Feature availability: The available features and models differ by region. For details, refer to feature availability by region and the list of available models.

Currently supported regions: Singapore, US (Virginia), China (Beijing), China (Hong Kong), Germany (Frankfurt)

All your static data is stored in your selected region to meet data residency requirements.

Using International deployment mode models

Configure the request address, API key, and model name:

• Request address (Base URL): For the International deployment mode, which is hosted in the Singapore region, use the dashscope-intl.aliyuncs.com domain name. For other APIs, see the corresponding documentation.

  • OpenAI Chat Completions API: https://dashscope-intl.aliyuncs.com/compatible-mode/v1

  • DashScope: https://dashscope-intl.aliyuncs.com/api/v1

• API key: Go to the Key Management (Singapore) page to get your API key.

• Model name: From the Model list, select a model that supports this deployment mode.

Using United States deployment mode models

Configure the request address, API key, and model name:

• Request address (Base URL): For the US deployment mode in the US (Virginia) region, use thedashscope-us.aliyuncs.com domain name. For other APIs, see the corresponding documentation.

  • OpenAI Chat Completions API: https://dashscope-us.aliyuncs.com/compatible-mode/v1

  • DashScope: https://dashscope-us.aliyuncs.com/api/v1

• API key: Go to the Key Management (Virginia) page to get your API key.

• Model name: From the Model list, select a model for the US deployment mode (with the -us suffix).

Using Global deployment mode models

The global deployment mode supports multiple regions. Select a region based on your business requirements.

Using Chinese Mainland deployment mode models

Using Hong Kong (China) deployment mode models

Using European Union deployment mode models

Asynchronous tasks

For an asynchronous task, such as image or video generation, all subsequent operations must use the same service domain name and API key that you used to create the task. Otherwise, the request will fail.

Example for Global deployment mode (US region). For Germany region, use {WorkspaceId}.eu-central-1.maas.aliyuncs.com:

# Create a task in the Global deployment mode (US region) with the service domain name dashscope-us.aliyuncs.com
curl --location 'https://dashscope-us.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--data '{
    "model": "wan2.6-t2i",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "text": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "n": 1
    }
}'

# Sample response: {"output":{"task_id":"abc123..."},"request_id":"..."}

# Query the task status. You must use the same service domain name.
curl -X GET https://dashscope-us.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

# [Error] Using a different service domain name for the query will cause an error.
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"