大模型服务平台百炼：如何选择部署模式

使用全球部署模式的模型

使用国际部署模式的模型

使用前，请先配置请求地址、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，否则会导致报错。

以下是在全球部署模式下创建图像生成任务并查询结果的示例：

# 创建任务（全球部署模式，服务域名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"