Alibaba Cloud Model Studio:How to choose a deployment mode

Models in Global deployment mode

Models in International deployment mode

Before using these models, configure the request address, API key, and model name:

• Request address (base URL): The international deployment mode is bound to the Singapore region. Use the dashscope-intl.aliyuncs.com domain name. The following are examples of request addresses. 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).

• Model name: See Model list and choose a model for the international deployment mode.

Models in United States deployment mode

Before using these models, configure the request address, API key, and model name:

• Request address (base URL): The US deployment mode is bound to the US (Virginia) region. Use the dashscope-us.aliyuncs.com domain name. The following are examples of request addresses. 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).

• Model name: See Model list and choose a model for the US deployment mode (with the -us suffix).

Models in Mainland China deployment mode

Asynchronous tasks

For asynchronous tasks, such as image generation and video generation, you must use the same service domain name and API key for all subsequent operations as were used when creating the task. Otherwise, an error occurs.

The following example shows how to create an image generation task and query its result in global deployment mode:

# Create task (global deployment mode, 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, beautiful wooden doors, and flowers."
                    }
                ]
            }
        ]
    },
    "parameters": {
        "n": 1
    }
}'

# Response example: {"output":{"task_id":"abc123..."},"request_id":"..."}

# Query task (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] Querying with a different service domain name causes an error
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"