API Key 创建/获取地址:
- 百炼控制台首页:
https://bailian.console.aliyun.com/ - API Key 管理页面(北京地域):
https://bailian.console.aliyun.com/cn-beijing#/api-key
操作路径:登录控制台 → 右上角选择地域(推荐华北2)→ 左侧导航栏「API Key」→ 点击「创建 API Key」→ 选择归属业务空间 → 确定。
⚠️ 注意:如果你用的是 Token Plan,需要使用 Token Plan 专属 API Key(以
sk-sp-开头),获取入口在 Token Plan 管理页面,不是上面这个通用 API Key 页面。
API 接口地址(Base URL):
百炼目前有两套域名体系,根据地域和调用方式选择:
| 调用方式 | 北京地域 | 新加坡地域 |
|---|---|---|
| OpenAI 兼容模式(推荐) | https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 |
| DashScope API | https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1 |
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1 |
| 传统 DashScope 域名(仍可用,建议迁移) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
其中 {WorkspaceId} 是你的业务空间 ID,在控制台「业务空间」页面可以查看。
快速调用示例(OpenAI 兼容模式):
from openai import OpenAI
client = OpenAI(
api_key="sk-xxx", # 你的 API Key
base_url="https://dashscope.aliyuncs.com/compatible-mode/v1" # 传统域名
# 或业务空间专属域名(推荐生产环境):
# base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
)
response = client.chat.completions.create(
model="qwen-plus",
messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
几个注意点:
- Base URL 必须与 API Key 同地域、同计费方案配套使用,否则会报 401 错误。
- 传统
dashscope.aliyuncs.com域名是共享的,官方建议生产环境迁移到业务空间专属域名({WorkspaceId}.{region}.maas.aliyuncs.com),可获得更高吞吐和流量隔离。 - 百炼完全兼容 OpenAI 协议,原来调 OpenAI 的代码只需改
base_url和api_key两个参数即可切换。
轻量云Cloud
