如何在华为云上开通MaaS服务并创建API Key,并在CodeArts Agent中配置使用API Key
目前AI编程越来越火热,带来的效率革命无人能敌。但是使用中经常会遇到Tokens额度不够等问题,可以通过本方法接入自选的模型API。
以下内容为个人使用后整理,实际配置时可能发生操作入口或方式变更,请以官方文档为准。
开通MaaS服务并开通模型创建API Key
前提条件
- 华为云账号:确保您已注册华为云账号。若未注册,需先完成注册华为账号并开通华为云。
- ModelArts委托授权:完成ModelArts Studio(MaaS)的委托授权配置。具体操作请参考配置ModelArts Studio(MaaS)访问授权。
ModelArts委托授权
在使用ModelArts平台的MaaS服务时,权限管理是保障服务正常运行和数据安全的关键环节。ModelArts平台所有功能均依托IAM体系进行权限管控,服务管理员可借此对用户进行精细化权限设置。
无论是个人用户还是其他类型用户,都需要完成ModelArts委托授权,这是使用MaaS服务的必要前提,否则将导致操作出现错误。对于个人用户而言,无需考虑细粒度权限问题,完成ModelArts委托授权后,即可使用ModelArts。
委托授权配置方式:
- ModelArts提供了一键式自动授权功能,用户可以在ModelArts的权限管理功能中,快速完成委托授权,由ModelArts为用户自动创建委托并配置到ModelArts服务中。
- 一键式自动授权方式支持给IAM子用户、联邦用户(虚拟IAM用户)、委托用户和所有用户授权。
具体操作步骤:
- 进入华为云, 登录ModelArts控制台(注意此处不是MaaS控制台),在左侧导航栏选择"权限管理>添加授权",进入授权列表页面。
- 单击"添加授权",进入"添加授权"配置页面。
- 配置授权参数:
- 授权对象类型:包括IAM子用户、联邦用户、委托用户和所有用户
- 授权对象:根据选择的授权对象类型选择具体用户
- 委托选择:可选择已有委托或新增委托单击"创建",根据授权提示,输入"Yes",单击"确定",即可完成委托配置。
重要说明:
当用户已拥有ModelArts的访问授权时,无需单独配置MaaS服务的访问授权。
ModelArts在执行AI计算任务过程中,需要"代表"用户去访问其他云服务,此动作需要提前获得用户的授权在IAM权限体系下,此类授权动作是通过"委托"来完成。
每个用户必须关联委托才可以使用ModelArts。
步骤详解
- 访问ModelArts Studio(MaaS)控制台
- 使用您的华为云账号登录ModelArts Studio(MaaS)控制台。
- 在顶部导航栏中,选择区域如西南-贵阳一。
- 进入API Key管理页面
- 在控制台左侧导航栏中,单击"API Key管理"。
- 创建API Key
- 在"API Key管理"页面,单击"创建API Key"按钮。
- 填写以下参数(注意:标签和描述在创建后不可修改):
- 标签:自定义API Key的唯一标识。仅支持大小写英文字母、数字、下划线、中划线,长度范围为1~100个字符。
- 描述:自定义API Key的用途说明,长度范围为1~100个字符。
- 确认信息后,单击"确定"完成创建。
- 重要提示:创建时显示的密钥仅在创建时显示一次,请务必复制并保存至安全位置。若密钥丢失,无法找回,需重新创建新的API Key。
- 开通预置模型
在ModelArts Studio(MaaS)控制台,在控制台左侧导航栏中,找到"模型推理""在线推理",点击预置服务,选择适合自己的服务开通服务(免费开通,按需收费,不使用不收费)。
补充说明
- API Key用途:用于调用MaaS平台的模型服务(如DeepSeek系列),需配合API地址和模型名称使用。
- 安全建议:避免将API Key暴露在公共代码或日志中,建议使用环境变量或密钥管理服务(如IAM)进行保护。
在CodeArts Agent中配置使用API Key
前提条件
- 已购买华为云码道(CodeArts)代码智能体专业版套餐。
- 账号已具备企业管理员权限。
管理系统内置模型
- 进入码道代码智能体控制台(可以在CodeArts Agent IDE右上角用户图标单击,点击第一行的专业版图标快捷进入)。
- 在左侧导航栏选择"企业设置 > 模型配置",进入"模型配置"页面。
- 在"系统内置模型"区域,单击目标模型后的开关,开启或关闭该模型。所有系统内置模型默认为开启状态。
关闭模型后,在华为云码道客户端的智能体模式中将不展示此模型。
新建企业自定义模型
- 进入码道代码智能体控制台。
- 在左侧导航栏选择"企业设置 > 模型配置",进入"模型配置"页面。
- 在"企业自定义模型"区域,单击"新建模型",弹出"新建企业自定义模型"对话框。
- 填写以下信息
- 模型名称: 业自定义模型的名称,长度不超过64个字符。自定义模型名称可与系统内置模型名称相同,但不可与其他已创建的自定义模型名称相同。
- 模型ID: 输入从模型供应商处获取的模型ID,长度不超过64个字符。例如:glm-5.1。
- 模型URL: 输入从模型供应商处获取的模型URL,仅填写API的基础路径。例如:模型完整地址为https://open.bigmodel.cn/api/paas/v4/chat/completions,应填写的模型URL为https://open.bigmodel.cn/api/paas/v4。
- API Key: 输入从模型供应商处获取的API Key。
- 描述: 可选,自定义模型的描述信息,长度不超过200个字符。
- 单击"确定",模型连通性测试成功后,企业自定义模型创建成功。
在"企业自定义模型"区域,查看新创建的模型。
应用企业自定义模型
新建企业自定义模型并将其启用后,企业内所有成员均可在华为云码道中使用该模型。
- 在左侧导航栏选择"智能体中心",进入"智能体中心"页面。
- 在系统内置的"智能体"后,单击"编辑",进入"编辑智能体"页面。
- 在"基础模型"下拉框中选择新建的企业自定义模型,单击右上角的"确定",将该模型添加到智能体中。
- 在华为云码道客户端的聊天界面输入框下方选择"内置智能体 > 智能体"或自定义智能体,在右侧的模型中选择新建的企业自定义模型,即可使用该自定义模型。
管理企业自定义模型
新建企业自定义模型后,可对其进行开启、编辑和删除等操作。
个人经验分享
由于本人主要用来进行辅助编码、调试,输入Tokens较多,经过筛选,开通了以下模型
- 模型ID: deepseek-v4-flash,模型URL: https://api.modelarts-maas.com/v2, 限流RPM:3
- 模型ID: qwen3-235b-a22b,模型URL: https://api.modelarts-maas.com/v2, 限流RPM:1500
- 模型ID: deepseek-v4-pro,模型URL: https://api.modelarts-maas.com/v2, 限流RPM:3
- 模型ID: glm-5.1, 模型URL: https://api.modelarts-maas.com/v2, 限流RPM:30
实际使用时,可根据自己使用情况选择更合适的模型。
注意模型的计费方式和限流是否满足自己的需求。
关于如何合理选择编程助手的模式并节约Token
请参考:
在享受AI编程助手带来的巨大便利的同时,有效控制其使用成本,实现效率与经济的双赢。