选择地域和服务部署范围

模型服务的地域是指您接入百炼模型服务的物理节点位置。选择地域时，请考量以下维度：

• 访问延迟：物理距离直接影响响应速度。建议选择靠近您或您的终端用户的地域，以最小化网络延迟。

• 合规准入：业务部署须符合当地法律法规，请根据您的合规诉求选择合适您的静态数据存储位置。

• 可用功能：不同地域支持的功能或模型可能不同，详情请参考各地域支持的功能和模型列表文档。

当前支持的地域：华北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"