获取阿里云百炼的 API Key 和 Base URL 其实不复杂,关键是要知道在控制台的哪个位置,以及不同地域对应的地址是不一样的。我把具体步骤和注意事项整理了一下。
阿里百炼平台API Key: https://bailian.console.aliyun.com/cn-beijing?tab=model#/api-key
阿里云百炼控制台模型广场: https://bailian.console.aliyun.com
🔑 获取 API Key 的步骤
-
登录控制台:首先,请使用你的阿里云主账号(或拥有相关权限的子账号),登录百炼控制台。
-
进入 API Key 管理页面:链接(
https://bailian.console.aliyun.com/cn-beijing?userCode=cb3vgkf5&tab=model#/api-key)就是直达路径。或者,你也可以在控制台左侧导航栏或顶部菜单中找到“API Key”管理页面。 -
创建并保存 API Key:
-
点击“创建 API Key”按钮。
-
在弹窗中,归属账号建议选择“主账号”,归属业务空间建议选择“默认业务空间”,然后点击确定。
-
这是最关键的一步:创建成功后,API Key 的明文只会显示一次,平台会进行加密存储,之后你就无法再在控制台看到了。所以,请务必立即复制并妥善保存到安全的地方(例如密码管理器),千万不要泄露。
-
📍 确定 Base URL(API 请求地址)
Base URL 由你选择的地域(Region) 和业务空间(WorkspaceId) 共同决定。两者需要匹配,不能混用。
-
华北2(北京)地域:这是很多教程使用的默认地域,Base URL 格式为
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1。你需要将{WorkspaceId}替换成你实际的业务空间 ID。业务空间 ID 可以在“业务空间管理”页面查看。 -
新加坡地域:
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 -
美国(弗吉尼亚)地域:
https://dashscope-us.aliyuncs.com/compatible-mode/v1(此地域的 Base URL 格式略有不同,无需填写 WorkspaceId)。 -
其他地域:如德国(法兰克福)、日本(东京)等,格式均为
https://{WorkspaceId}.{region-code}.maas.aliyuncs.com/compatible-mode/v1。具体的 region-code 可以参考阿里云官方文档。
简单来说,在代码中调用时,配置会像这样(以新加坡地域为例):
from openai import OpenAI client = OpenAI( api_key="你的API Key", # 这里填入你刚刚保存的API Key base_url="https://你的WorkspaceId.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1" )
🧭 关于阿里云百炼平台
阿里云百炼是一个一站式的大模型服务平台,它的目标是让开发者能更简单、低成本地使用和开发AI应用。
简单来说,它有几个核心优势:
-
模型丰富:它不仅提供了阿里自研的“千问(Qwen)”全系列模型,还集成了DeepSeek、智谱、MiniMax等主流第三方模型,你可以在一个平台上按需选用。
-
开发便捷:平台兼容OpenAI的API接口规范,如果你之前用过OpenAI,可以很轻松地迁移代码。此外,它还提供了RAG(检索增强生成)、智能体(Agent)编排等高级功能的API和工具,方便构建更复杂的应用。
-
成本灵活:支持按Token用量计费,用多少付多少,对个人开发者和初创企业很友好。对于高并发的企业场景,也提供了专属资源部署的选项。
轻量云Cloud
