开发者社区 阿里云百炼 文章 正文

阿里云百炼平台如何使用？获取与配置 API Key教程与常见问题解答

2026-09-02 477
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 本文介绍了阿里云百炼平台API Key的获取、配置与管理全流程。文章首先说明需在控制台密钥管理页面创建或获取API Key，并强调了通过环境变量配置以保障安全的核心建议。具体步骤分为获取与配置两步：获取时需注意权限要求与空间归属选择；配置部分则提供了在第三方工具中直接填写，以及在Linux、macOS、Windows系统下通过命令行设置永久或临时环境变量的详尽操作指南。此外，文章还梳理了API Key的权限机制、配额限制、安全提醒及常见问题解答，旨在帮助开发者安全、高效地完成认证接入，为调用百炼平台各项AI服务奠定基础。

阿里云百炼平台 API Key 的获取与配置需在控制台密钥管理页面完成，并建议通过环境变量方式配置以降低泄露风险。在控制台获取或创建 API Key 后，您将使用它来安全地调用百炼的模型服务。注意事项

  • 权限要求：创建 API Key 需使用超级管理员或业务空间管理员账号；RAM 子账号需先由主账号授权后方可创建。
  • 配额限制：每个主账号下最多可创建 20 个业务空间，每个业务空间下最多可创建 20 个 API Key。
  • 安全提醒：请勿以任何方式公开 API Key，避免因未授权使用造成安全风险或资金损失。
  • 权限范围：API Key 的调用权限由其归属业务空间决定，同一空间内的 API Key 权限相同，无需为不同模型创建不同的 Key。
  • 更多阿里云百炼平台知识可参考：https://www.aliyun.com/product/bailian

创建APIKey.png

第一步：获取 API Key

  1. 前往阿里云百炼的密钥管理（中国大陆版| 国际版）页面。

  2. 若已有可用 API Key，直接在列表中复制即可。若需创建，请遵循以下步骤：

    1. 在API Key 页签单击创建 API Key。若无法创建，请联系您的组织或 IT 管理员。

    2. 在创建 API Key弹窗中，选择 API Key 的归属账号及归属业务空间，并单击确定。

      • 归属账号：选择阿里云账号（主账号）即可，账号名通常为一串数字。

        如需为团队成员或应用创建权责独立的 API Key，并结合归属业务空间进行精细化的模型访问控制，归属账号应选择RAM 用户。

        RAM 用户的账号格式为username@<AccountAlias>.onaliyun.com。

      • 归属业务空间：选择“默认业务空间”，此空间下的 Key 可调用所有标准模型。

        单个业务空间最多支持创建 20 个 API Key。

        如需以下功能，请选择非默认的业务空间：

        • 对不同项目（业务空间）进行权限隔离
        • 精细化的模型访问控制
        • 进行独立的成本核算

      • 权限：建议选择全部，若有更精细的权限控制需求，可以选择自定义来控制可访问 IP 和 可访问模型。

        IP 白名单默认设置：IPv4（0.0.0.0/0）全部放通；IPv6 仅华北2（北京）地域支持，美国（弗吉尼亚）地域仅支持 IPv4。最多支持 20 个地址或网段，批量输入请用英文逗号隔开。

    3. 点击新创建的 API Key 旁的image图标复制 API Key。

第二步：配置 API Key

  • 方式一：在第三方工具中进行配置

    如果在 Chatbox 等工具或平台中调用模型，您可能需要输入三个信息：

    • 本文获取的 API Key

    • Base URL：

      • 中国大陆版：https://dashscope.aliyuncs.com/compatible-mode/v1
      • 国际版：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
    • 模型名称，如 qwen-plus、qwen3-8b、deepseek-r1 等。

  • 方式二：配置 API Key 到环境变量，后续支持 cURL 和代码调用

    重要请勿在客户端代码（如浏览器、移动应用）或不可信环境中配置或使用长期有效的 API Key。可以使用临时 API Key（最长 1800 秒）。

    请将<YOUR_API_KEY> 部分替换为真实的 API Key。

    Linux系统

    添加永久性环境变量

    将环境变量设置追加到~/.bashrc文件中。

    echo "export DASHSCOPE_API_KEY='<YOUR_API_KEY>'" >> ~/.bashrc
source ~/.bashrc
echo "百炼 API Key 永久配置为：${DASHSCOPE_API_KEY:0:10}*"

    添加临时性环境变量

    export DASHSCOPE_API_KEY='<YOUR_API_KEY>'
echo "当前会话百炼 API Key 配置为：${DASHSCOPE_API_KEY:0:10}*"

    服务管理器 (systemd)

    以下操作适用于将应用作为后台服务部署的场景。

    1. 创建环境文件
    sudo sh -c "echo 'DASHSCOPE_API_KEY=<YOUR_API_KEY>' > /etc/your-app/env"
sudo chmod 600 /etc/your-app/env # 限制只有root用户有访问权限
    1. 修改 systemd 服务文件（如 /etc/systemd/system/your-app.service）：
    [Service]
# 加载密钥文件
EnvironmentFile=/etc/your-app/env
ExecStart=/usr/bin/python /opt/your-app/main.py
    1. 重载服务
    sudo systemctl daemon-reload
sudo systemctl restart your-app

    macOS系统

    添加永久性环境变量

    将环境变量设置追加到~/.bash_profile或~/.zshrc文件中。

    VAR_VALUE="<YOUR_API_KEY>"; \
echo "export DASHSCOPE_API_KEY='$VAR_VALUE'" >> ~/.zshrc 2>/dev/null
echo "export DASHSCOPE_API_KEY='$VAR_VALUE'" >> ~/.bash_profile 2>/dev/null
source ~/."${SHELL##*/}rc" 2>/dev/null
echo "百炼 API Key 永久配置为：${DASHSCOPE_API_KEY:0:10}*"

    添加临时性环境变量

    export DASHSCOPE_API_KEY='<YOUR_API_KEY>'
echo "当前会话百炼 API Key 配置为：${DASHSCOPE_API_KEY:0:10}*"

    Windows系统

    在Windows系统中，您可以通过系统属性、CMD或PowerShell配置环境变量。

    系统属性

    说明

    • 此方式配置的环境变量永久生效。
    • 修改系统环境变量需具备管理员权限。
    • 配置环境变量后不会立即影响已经打开的命令窗口、IDE或其他正在运行的应用程序。您需要重新启动这些程序或者打开新的命令行使环境变量生效。

    1. 在Windows系统桌面中按Win+Q键，在搜索框中搜索编辑系统环境变量，单击打开系统属性界面。

    2. 在系统属性窗口，单击环境变量，然后在系统变量区域下单击新建，变量名填入DASHSCOPE_API_KEY，变量值填入您的DashScope API Key。

    3. 依次单击三个窗口的确定，关闭系统属性配置页面，完成环境变量配置。

    4. 打开CMD（命令提示符）窗口或Windows PowerShell窗口，执行如下命令检查环境变量是否生效。

      • CMD查询命令：
    echo 百炼 API Key 永久配置为：%DASHSCOPE_API_KEY:~0,10%*
    • Windows PowerShell查询命令：
    Write-Host "百炼 API Key 永久配置为：$($env:DASHSCOPE_API_KEY.Substring(0, [Math]::Min(10, $env:DASHSCOPE_API_KEY.Length)))*"

    CMD

    添加永久性环境变量

    如果您希望API Key环境变量在当前用户的所有新会话中生效，可以按如下操作。

    1. 在CMD中运行以下命令。
    setx DASHSCOPE_API_KEY "<YOUR_API_KEY>"
    1. 打开一个新的CMD窗口。
    2. 在新的CMD窗口运行以下命令，检查环境变量是否生效。
    echo 百炼 API Key 永久配置为：%DASHSCOPE_API_KEY:~0,10%*

    添加临时性环境变量

    如果您仅希望在当前会话中使用该环境变量，可以在CMD中运行以下命令。

    set "DASHSCOPE_API_KEY=<YOUR_API_KEY>"

    您可以在当前会话运行以下命令检查环境变量是否生效。

    echo 当前会话百炼 API Key 配置为：%DASHSCOPE_API_KEY:~0,10%*

    PowerShell

    添加永久性环境变量

    如果您希望API Key环境变量在当前用户的所有新会话中生效，可以按如下操作。

1.在PowerShell中运行以下命令。

```
[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "<YOUR_API_KEY>", [EnvironmentVariableTarget]::User)```

2.打开一个新的PowerShell窗口。

3.在新的PowerShell窗口运行以下命令，检查环境变量是否生效。

    Write-Host "百炼 API Key 永久配置为：$($env:DASHSCOPE_API_KEY.Substring(0, [Math]::Min(10, $env:DASHSCOPE_API_KEY.Length)))*"

添加临时性环境变量

如果您仅希望在当前会话中使用该环境变量，可以在PowerShell中运行以下命令。

```
$env:DASHSCOPE_API_KEY = "<YOUR_API_KEY>"
Write-Host "当前会话百炼 API Key 配置为：$($env:DASHSCOPE_API_KEY.Substring(0, [Math]::Min(10, $env:DASHSCOPE_API_KEY.Length)))*"
```

API Key 时效性说明

API Key 没有失效时间限制，若需要有时效性的 API Key，可生成临时 API Key（有效期最多1800秒）。

API Key 的状态随账号操作而变化：

触发操作 主账号的 API Key RAM 账号的 API Key
主动删除 API Key 不支持 失效，不可恢复 不支持 失效，不可恢复
将账号移出业务空间 — 不支持 失效 > 重新加入业务空间后 API Key 恢复生效
在RAM 控制台删除账号/角色 — 不支持 失效，不可恢复

API 调用

请访问文本生成以及更多模型的 API 参考。
OpenAI SDK 支持的模型。

常见问题

无法创建 API Key？

API Key 的创建需使用超级管理员)或业务空间管理员操作。

如何管理 API Key 的权限？

API Key 的调用权限完全由其归属业务空间决定。同一空间内的 API Key 权限相同，无需为不同模型（如文生文、文生图、语音合成）创建不同的 API Key。

  • 默认业务空间下的 API Key：可调用所有标准模型，以及默认业务空间内的应用。
  • 子业务空间下的 API Key：可调用该子业务空间已获得模型调用授权的标准模型，以及该业务空间内的应用。

调用在阿里云百炼调优后的模型：此类模型部署成功后，仅能用其所在业务空间的API Key调用。

如需在业务空间之外做更细粒度的控制，可在创建或编辑 API Key 时将权限切换为自定义，配置：

  • IP 访问白名单：仅允许名单内的 IP 使用该 API Key 发起调用。支持 IPv4 与网段，默认 IPv4（0.0.0.0/0）全部放通；IPv6 仅华北2（北京）地域支持，美国（弗吉尼亚）地域仅支持 IPv4。最多支持 20 个地址或网段，批量输入请用英文逗号隔开。
  • 访问模型范围：开关开启后，该 API Key 仅能调用已勾选的模型，可选模型限于该业务空间已授权的模型。

环境变量已设置，为何代码仍提示找不到 API Key？

具体原因如下：

  • 情况一：没有设置永久性环境变量。临时环境变量只在当前终端会话中有效，对于已经启动的 IDE 或其他应用程序并不会生效。请参考本文中设置永久性环境变量的方法。

  • 情况二：没有重启IDE、命令行工具或应用。

    • 通常需要重启 IDE（如 VS Code）或命令行工具，使其能够加载最新的环境变量。
    • 如果在部署应用后设置了环境变量，可能需要重启应用服务，让应用能够重新加载环境变量。

  • 情况三：需要在配置文件添加环境变量。如果您的应用是通过服务管理器（如 systemd、supervisord）启动的，可能需要在服务管理器的配置文件中添加环境变量。

  • 情况四：用了sudo命令。如果使用sudo python xx.py运行脚本，可能会遗漏当前用户环境变量，因为sudo默认不继承所有环境变量。您可采用sudo -E python xx.py命令，其中的-E 参数确保环境变量被传递。如有权限执行该脚本，可以直接执行 python xx.py。

单个主账号下最多能创建多少个API Key？

每个主账号下最多可创建20个业务空间（包括默认业务空间），每个业务空间下最多可创建20个API Key。

2026年阿里云AI产品与云产品优惠权益参考：
AI 产品权益主要包括智启 AI 普惠权益，至高享 1亿+免费 tokens，加速 Al 应用落地；Token Plan 模型订阅计划，Qwen3.8-Max 首发尝鲜，限时加量 10 倍，夜间低至2折；千问办公，限时限量积分加倍，你的AI工作搭子，覆盖日常办公高频场景；万小智 AI 建站低至 15元/月，送.CN域名，送备案服务码；Night Plan 支持 Qwen 3.8-Max，夜间 5 折，Qwen/Meoo/TokenPlan 客户专享。而云产品权益主要有轻量应用服务器限时抢购2核2G38元/年；经济型e实例3.9折，通用算力型u2i实例3折，九代c9i、g9i、r9i等实例1年付6.4折起等优惠权益。详情可通过阿里云权益中心了解：https://www.aliyun.com/benefit

云启AI普惠权益2026.png

总而言之，API Key是安全调用阿里云百炼平台模型服务的核心凭证。用户需在控制台密钥管理页面完成创建与获取，并建议优先通过环境变量方式进行安全配置，以规避泄露风险。创建时需关注权限要求与配额限制，注意API Key的调用权限由其归属的业务空间统一决定，无需为不同模型创建不同密钥。遵循文中的步骤与安全建议，妥善管理API Key，是确保应用稳定运行与数据资产安全的第一步，也是高效利用百炼平台强大AI能力的基础保障。

文章标签：
大模型服务平台百炼
API
安全
人工智能
数据安全/隐私保护
Windows
云计算学习者
目录
相关文章
云百科
|
23天前
|
IDE API 开发工具
阿里云百炼 API Key 获取教程：控制台一键创建、sk- 密钥仅显示一次如何保存（附 Dify/Chatbox 配置）
阿里云百炼API Key获取教程：控制台一键创建，sk-密钥仅显示一次需立即保存；开通即赠7000万Tokens（每模型100万），支持Dify/Chatbox等工具配置及环境变量调用。在阿里云百炼官网：https://t.aliyun.com/U/fPVHqY 免费领取千万Tokens
云百科
164 0
云服务器吧
|
25天前
|
人工智能 IDE API
怎么获取API Key？阿里云百炼的API Key创建教程，有图超简单！
阿里云百炼是AI大模型服务平台，新用户开通即赠超7000万免费Tokens。本文详解API Key获取三步法：登录控制台→进入API Key页面→点击创建并配置权限（归属账号、业务空间、权限范围），支持环境变量或第三方工具快速调用。在阿里云百炼官网：https://t.aliyun.com/U/fPVHqY 免费领取千万Tokens
云服务器吧
294 0
30577918
|
11天前
|
人工智能 数据可视化 JavaScript
阿里云百炼平台介绍2026：官网入口链接、免费AI大模型领取及常见问题解答FAQ
阿里云百炼（Model Studio）是一站式大模型服务平台，集成通义千问、DeepSeek、Kimi等百余款主流模型；支持OpenAI兼容API、可视化应用构建、模型微调与部署，新用户享7000万Token免费额度（90天有效期）。
30577918
434 0
OpenClaw
|
23天前
|
存储 人工智能 缓存
【新版】阿里云 百炼大模型平台 产品功能介绍及配置价格表
大模型应用开发链路包含模型选型、推理调用、数据集处理、模型调优、知识库构建、智能体编排、业务上线、成本管控等大量环节，如果分散在多个不同平台完成整套流程，会带来账号管理复杂、接口不统一、数据流转繁琐、成本难以统计等诸多痛点。阿里云百炼是面向开发者与企业打造的一站式大模型开发服务平台，把模型调用、数据集管理、模型微调、专属部署、向量知识库、智能体应用、MCP工具广场、用量计费管控全部整合到统一控制台，既提供开箱即用的海量预训练模型，也支持开发者完成自定义模型优化与业务应用搭建，降低AI应用从原型验证走向正式业务的技术门槛。
OpenClaw
281 0
云计算学习者
|
25天前
|
人工智能 自然语言处理 API
阿里云百炼大模型服务平台介绍：百炼是什么、适用场景、使用教程及最新活动
本文介绍2026年升级为“模型工厂+应用引擎”双核心架构的阿里云百炼一站式MaaS大模型平台。平台聚合通义千问全系列及DeepSeek、GLM等150余款主流大模型，覆盖模型调用、微调、知识库构建、智能体开发到应用部署全链路，具备企业级安全合规与灵活计费优势。文中附首次调用千问API实操教程，新用户可领单模型100万Token免费额度，同步最新订阅优惠与限时活动，助力开发者低成本落地AI应用。
云计算学习者
618 0
云计算学习者
|
20天前
|
人工智能 自然语言处理 安全
阿里云百炼大模型服务平台是什么？平台功能与能力、模型服务、应用构建及新用户免费额度介绍
阿里云百炼一站式大模型服务平台正式上线Wan3.0原生3D视频生成大模型，同步推出Token Plan个人版包月39元起等多档灵活计费方案，新用户开通即享超1亿免费Tokens。平台聚合百余款主流模型，覆盖从模型推理、Agent开发到企业级RAG知识库的全链路能力，兼容OpenAI接口规范，支持CLI命令行调用，帮助不同技术背景的用户低成本完成AI应用落地。
云计算学习者
246 0
云计算学习者
|
25天前
|
人工智能 自然语言处理 JavaScript
最新版阿里云全模型通用节省计划介绍：核心优势、适用场景、模型调用方式及活动解析
阿里云百炼平台推出的全模型通用节省计划介绍，针对大模型调用成本高的行业痛点展开全面解析。该计划是面向大模型场景的预付费折扣方案，核心优势在于跨模型通用、无模型锁定风险，相比按量付费可大幅降低调用成本，同时抵扣规则透明、支持多付费周期选择。文章明确了其适配企业级AI开发、多模型混合调用等五大典型场景，梳理了覆盖通义千问全系列、多模态、代码类等主流模型的支持范围与抵扣逻辑，最后附上当前新购低至4.5折的最新活动档位与优惠券使用指引，帮助用户结合业务规模实现AI调用成本的最优管控。
云计算学习者
136 3
32ea2c6h24f0eeLvbTg
|
9月前
|
JavaScript Shell API
阿里云百炼 API 调用教程：准备 API-Key、配置环境变量和调用 API 流程
在使用阿里云百炼平台的大模型能力时，API 调用是核心环节 —— 无论是开发 AI 应用、测试模型效果，还是搭建智能服务，都需要通过 API 将大模型能力集成到自己的系统中。不过对很多开发者来说，从准备密钥到实际调用的流程可能存在疑问，比如 “API-Key 怎么获取”“环境变量配置有什么用”“不同语言怎么写调用代码”。本文结合最新的实操细节，用通俗的语言把整个流程拆解开，从账号准备到多语言调用，每一步都附具体操作和代码示例，帮大家快速上手。
32ea2c6h24f0eeLvbTg
20557 113
云计算学习者
|
25天前
|
人工智能 自然语言处理 前端开发
阿里云万小智AI建站产品解析：使用场景、产品优势、使用教程与最新活动
本文介绍阿里云企业级AI建站平台万小智2.0，它依托大模型与代码生成技术，通过自然语言对话即可生成含前端、后端、数据库的完整网站，打通从建站、域名备案到上线的全流程。当前活动推出9.9元/月起的多档特惠套餐，新用户可享2000灵感值、.CN域名、备案服务码三大福利，助力中小企业快速搭建官网与轻量业务站点。
云计算学习者
146 1
云计算学习者
|
5天前
|
人工智能 自然语言处理 前端开发
阿里云万小智3.0AI建站：首单低至15元/月，送域名证书备案一站式上线
万小智3.0是阿里云推出的AI建站产品，依托大语言模型和代码生成技术，用户只需通过自然语言描述需求，即可自动生成包含前端页面、后端服务、数据库在内的完整网站项目，并支持一键部署上线。该产品适用于中小企业官网、内容资讯、在线预约及轻量级业务应用等场景的快速构建与迭代，首次生成网站仅需5～10分钟，同时提供可视化编辑器、域名管理、HTTPS证书自动配置及基础SEO管理等能力。
云计算学习者
71 0

阿里云百炼

热门文章

最新文章

  • 1
    python代码简单模拟Java中的MVC设计
  • 2
    数据中心网络带宽线速有门道
  • 3
    字符编码知识以及相互之间的转换
  • 4
    通过编程发现Java死锁
  • 5
    HTTP协议初认识、速了解
  • 6
    阿里云百炼平台介绍：官网入口链接、免费AI大模型领取及常见问题解答FAQ
  • 7
    阿里云大模型服务平台百炼是如何收费的？阶梯计费规则与不同模型最新调用收费标准参考
  • 8
    阿里云百炼 API 调用教程：准备 API-Key、配置环境变量和调用 API 流程
  • 9
    【SpringAIAlibaba新手村系列】（1）初识 Spring AI Alibaba 框架
  • 10
    从零搭建企业私有知识库：RAG + 大模型实战（附完整代码）
  • 1
    多模态 AI 模型的商业应用场景
    19
  • 2
    【Luck‑Report】 AI 智能报表助手 + RAG 知识库 + 报表引擎
    22
  • 3
    AI 视频翻译工具技术演进分析：从 ASR 到多模态端到端，以讯飞译制相关功能为例
    30
  • 4
    阿里云大模型便宜购买方法：错峰折扣+订阅+节省计划，从免费额度到订阅选型全指南
    33
  • 5
    阿里云Token Plan最新升级：个人版价格不变，新增Harness权益 覆盖模型调用与Agent全流程
    34
  • 6
    阿里云百炼 Token Plan 全解：统一 Credits 计费、底层架构与 API 接入实战教程
    28
  • 7
    百炼声景模型新成员实测：Qwen-Audio-3.1-TTS-Next 的调用路径、时序控制与成本边界
    44
  • 8
    阿里云百炼大模型服务免费Tokens怎么领？每个模型免费Token额度及7000万Tokens领取教程
    44
  • 9
    【2026.09.20~09.24】阿里云百炼最新产品动态周报
    56
  • 10
    240GB流量击穿与频繁OOM：从云端瘫痪到客户端自治的本地优先架构重构实录
    55

    • 相关电子书

    更多
  • 低代码开发师（初级）实战教程
  • 冬季实战营第三期：MySQL数据库进阶实战
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    一条命令迁移，帮你实现 OpenClaw 与 Hermes Agent 记忆互通！