Alibaba Cloud Model Studio：選擇地區和部署模式

模型服務的地區是指您接入百鍊模型服務的物理節點位置。選擇地區時，請考量以下維度：

• 訪問延遲：物理距離直接影響響應速度。建議選擇靠近您或您的終端使用者的地區，以最小化網路延遲。

• 合規准入：業務部署須符合當地法律法規，請根據您的合規訴求選擇合適您的待用資料儲存位置。

• 可用功能：不同地區支援的功能或模型可能不同，詳情請參考各地區支援的功能和模型列表文檔。

當前支援的地區：新加坡、美國（維吉尼亞）、華北2（北京）、中國香港、德國（法蘭克福）

所有使用者待用資料均儲存在所選地區，符合本機資料駐留要求。

使用国际部署模式的模型

使用前，請先配置請求地址、API Key和模型名稱：

• 請求地址（Base URL）：國際部署模式綁定新加坡地區，請使用dashscope-intl.aliyuncs.com網域名稱。以下為部分請求地址樣本，其他 API 請參考對應文檔：

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

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

• API Key：請前往密鑰管理（新加坡）頁面擷取。

• 模型名稱：請參考模型列表，選擇國際部署模式的模型。

使用美国部署模式的模型

使用前，請先配置請求地址、API Key和模型名稱：

• 請求地址（Base URL）：美國部署模式綁定美國（維吉尼亞）地區，請使用dashscope-us.aliyuncs.com網域名稱。以下為部分請求地址樣本，其他 API 請參考對應文檔：

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

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

• API Key：請前往密鑰管理（維吉尼亞）頁面擷取。

• 模型名稱：請參考模型列表，選擇美國部署模式的模型（帶-us尾碼）。

使用全球部署模式的模型

全球部署模式支援多個地區，請根據您的業務需求選擇合適的地區。

使用中国内地部署模式的模型

使用中国香港部署模式的模型

使用欧盟部署模式的模型

非同步任務

對於非同步任務（如映像產生、視頻產生），所有後續操作必須使用建立任務時所用的服務網域名稱和 API Key，否則會導致報錯。

以下是在全球部署模式（美國地區）下建立映像產生任務並查詢結果的樣本。如使用德國地區，請將服務網域名稱替換為{WorkspaceId}.eu-central-1.maas.aliyuncs.com：

# 建立任務（全球部署模式-美國地區，服務網域名稱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": "一間有著精緻窗戶的花店，漂亮的木質門，擺放著花朵"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "n": 1
    }
}'

# 響應樣本：{"output":{"task_id":"abc123..."},"request_id":"..."}

# 查詢任務（必須使用相同服務網域名稱）
curl -X GET https://dashscope-us.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

# [錯誤] 使用其他服務網域名稱查詢將導致報錯
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"