ZCode

前提条件

• 已注册华为云账号，并进行实名认证。具体操作，请参见注册华为云账号和实名认证。
• 已开通预置服务，或已创建接入点。具体操作，请参见开通预置服务或创建自定义接入点。

计费说明

在调用MaaS模型服务时，将根据实际使用的Tokens数量进行计费。计费详情请参见MaaS文本生成模型。

约束限制

该功能仅支持“西南-贵阳一”区域。

步骤一：安装ZCode

在ZCode官网下载并安装对应操作系统的版本。ZCode支持macOS、Windows和Linux。

安装完成后，打开ZCode，可选择连接Z.ai账号、BigModel账号或使用API Key接入模型。本文以使用API Key接入MaaS模型为例。

步骤二：接入MaaS模型API

1. 打开ZCode，在对话框下方单击模型选择器，选择“管理模型”。如下图所示：
   图1 打开模型设置页面
   

2. 进入“模型设置”页面，在右上角单击“添加供应商”，选择“创建自定义供应商”，如图所示：
   图2 添加供应商
   

3. 在“添加供应商”页面，参考下表配置。
   图3 设置自定义供应商
   

   表1 自定义供应商配置

   参数	说明	示例
   供应商名称	自定义供应商名称。 单击右上角，选择“重命名”	华为云MaaS
   Base URL	必填。 Chat Completions格式，路径如下： https://api.modelarts-maas.com/v2 https://api.modelarts-maas.com/openai/v1 Anthropic Messages格式，路径如下： https://api.modelarts-maas.com/anthropic	https://api.modelarts-maas.com/openai/v1
   API格式	必填。 Chat Completions格式 Anthropic Messages格式	选择Chat Completions格式
   API Key	必填。 可使用已有的API Key，如果没有可获取API Key。	gA4ocs*****Tc-Kz4AQ

4. 单击“添加模型”，按照下表配置模型。在添加模型页面，参考下表配置。
   图4 配置模型示例
   

   表2 模型配置

   参数	说明	示例
   模型ID	必填。 从模型列表中的“模型参数”中获取。	deepseek-v4.1-flash
   上下文窗口	必填。 模型一次可处理的上下文容量，单位为Token。 可智能配置，配置为模型支持的上限。可从模型列表中的“长度限制”中查看模型支持的上限。 请勿超过模型的实际上下文限制。	1,000,000
   最大输出Token	必填。 单次模型请求允许生成的最大Token数，单位为Token。 可智能配置，配置为模型支持的上限。可从模型列表中的“长度限制”中查看模型支持的上限。 请勿超过模型的实际上下文限制。	384,000
   高级配置	选填。可设置输入类型、模型能力、推理等级等。	-

5. 单击“保存”后，单击模型操作栏的“测试模型”，连接成功表示模型添加成功。
   图5 测试模型
   

   

步骤三：使用ZCode

1. 在ZCode主页面左侧导航栏，选择“新建任务”，进入对话框，在对话框下方选择步骤二：接入MaaS模型API配置的模型，如下图所示：
   图6 选择模型
   

2. 在对话框进行对话，体验模型，如下图所示：
   图7 对话示例
   

常见报错