Cube Agent

Cube Agent 是一款面向鸿蒙设备的原生 AI 对话助手与工作台，适配手机、平板等设备，支持多模型对话、独立助手、Markdown 渲染、文档解析，以及联网搜索和 MCP 工具扩展，可用于日常问答、学习、写作和代码辅助。

Cube Agent 已接入硅基流动提供的合作免费模型。连接 Cube Agent 云服务后，无需自行填写 API Key，即可选择内置模型开始对话；也可以配置个人硅基流动 API Key，使用更多模型。

1. 下载与安装

前往 华为应用市场 下载并安装 Cube Agent。支持的设备、系统版本及安装条件以应用市场页面显示为准。

下文以应用中文界面为例，不同设备上的布局可能略有差异。

2. 直接使用硅基流动免费模型

使用内置免费模型，不需要先到硅基流动平台申请个人 API Key。应用会在连接 Cube Agent 云服务后自动准备合作配置，模型请求直接发送至硅基流动官方接口。

2.1 首次使用：通过新手引导开始

1. 首次打开 Cube Agent，在引导中选择「我是第一次用这类工具」，继续进入「先送你免费模型」页面。
2. 点击「连接云服务」，按提示完成华为账号验证与云服务授权。
3. 连接成功后，应用会准备「硅基流动（内置）」服务及相应模型。若仍停留在该页面，点击「开始体验」，完成后续引导。

整个过程无需手动填写 API Key、接口地址或模型 ID。

2.2 已跳过引导：从设置中开启

1. 打开「设置」，点击顶部账号卡，进入「会员中心」。
2. 按提示完成华为账号验证，并在「账号与服务」区域连接「Cube Agent 云服务」。已连接的用户可跳过这一步。
3. 返回设置，在「模型配置」分组中打开「服务商管理」，找到「硅基流动（内置）」，确认服务商已启用。进入其「模型」标签页，即可查看当前合作模型目录。

完成华为账号验证，不等于已经连接 Cube Agent 云服务。使用内置合作模型需要云服务处于已连接状态。应用不会覆盖你已有的默认模型配置，已有配置的用户可在聊天页手动切换。

上图的 Pro 身份与额度属于演示账号状态，不代表使用内置合作免费模型需要购买 Pro。图中的「免费模型试用」也是另一项服务，不是本文内置合作模型的额度。

进入内置服务商详情后，「配置」标签页会显示合作服务说明；这里不需要填写个人密钥。

2.3 选择模型并开始对话

以下为本文使用的合作目录配置示例。实际可用模型由云服务更新，请以应用内「硅基流动（内置）→ 模型」页面显示为准。

新建对话，打开模型选择器，选择「硅基流动（内置）」下的对话模型。

发送一条消息，确认能够正常收到回复，例如：

我正在学习 Python，请解释列表与元组的区别，用 Markdown 表格总结，并各给一个简单的代码示例。

收到回复后，即可继续追问，或将模型用于写作润色、文本总结和学习辅助。

免费模型通过在线服务提供，实际可用范围、访问限制和服务状态以应用及硅基流动的说明为准。「硅基流动（内置）」的配置由云服务管理，无需手动修改；使用个人 API Key 时，请按下一节配置独立的「硅基流动」服务商。

3. 自定义配置 SiliconFlow API Key

需要使用合作目录之外的模型时，可以配置自己的硅基流动 API Key。个人配置与「硅基流动（内置）」是两个独立入口，可以同时保留，按需切换。

3.1 获取硅基流动 API Key

1. 通过 Cube Agent 专属邀请链接注册硅基流动。已有账号的用户可直接 登录硅基流动平台。
2. 按平台要求完成 实名认证。
3. 进入 API 密钥管理 页面，点击「新建 API 密钥」，填写用途描述（例如 Cube Agent），再点击「新建密钥」，创建后复制完整密钥。详细操作可参阅 硅基流动快速上手。

邀请福利：新用户通过上述邀请链接注册并完成实名认证，符合活动条件后，你与邀请方均可获得 16 元代金券。这属于硅基流动平台的邀请奖励，与 Cube Agent 内置免费模型是不同的权益；奖励资格、活动时间、发放及使用规则以 硅基流动「推荐官」计划 和平台活动页面为准。

API Key 是调用服务的凭证。请妥善保存，只将其填入应用的密钥配置项，不要发送到聊天中，也不要公开包含完整密钥的截图或配置文件。

3.2 在 Cube Agent 中填写接入信息

打开「设置」，在「模型配置」分组中进入「服务商管理」，选择普通的「硅基流动」。若未找到，可搜索服务商名称，或切换到「已禁用」列表查看。

这里应选择「硅基流动」，而不是「硅基流动（内置）」。内置入口不提供个人 API Key 的编辑功能。

在服务商详情的「配置」标签页中填写：

接入地址采用 硅基流动官方文档中的 OpenAI 兼容配置。不要把完整的 /chat/completions 请求地址填入 Base URL，也不要重复添加 /v1。

填写完成后，点击 API Key 输入框旁的「测试连接」。出现「连接成功」提示后，继续选择模型。

3.3 获取模型并保存

1. 切换到服务商详情的「模型」标签页，点击「获取模型」。
2. 在弹出的列表中，搜索并勾选需要使用的对话模型，确认选择。
3. 确认所选模型已启用，并确保「硅基流动」服务商处于启用状态。
4. 点击页面的「保存」按钮或保存图标，完成配置。

如果需要的模型没有出现在列表中，可在「模型」标签页点击「添加」，手动填写模型 ID。请从 硅基流动模型广场 复制准确的模型 ID，保留组织名前缀、大小写及完整名称，不要使用自行缩写的展示名。

模型是否可调用，仍取决于硅基流动平台当前提供的服务和你的账号权限；手动添加模型不会开通额外权限。

3.4 验证对话

返回聊天页面，新建对话，在模型选择器中选择普通「硅基流动」下刚刚启用的模型，然后发送：

你好，请用三句话介绍你能帮助我完成哪些任务。

正常收到回复，即完成个人 API Key 的接入验证。后续也可以在同一服务商下启用其他对话模型，按不同任务切换使用。

使用个人 API Key 时，调用按你的硅基流动账号及所选模型规则处理，不代表平台上的所有模型都免费。模型价格、访问限制及可用性请查看 模型广场，费用与用量以硅基流动平台记录为准。

4. 常见问题

看不到「硅基流动（内置）」怎么办？

先确认使用的是包含合作免费模型功能的应用版本，并已连接 Cube Agent 云服务，而不只是完成华为账号验证。检查网络后，可重新打开应用，让配置重新加载；也请检查服务商是否被手动禁用。

断开 Cube Agent 云服务后，内置合作配置会被移除。重新连接后，应用会重新获取配置。个人 API Key 配置是独立的，不需要改填到内置入口。

「硅基流动（内置）」和应用中的「免费模型试用」是同一项服务吗？

不是。本文介绍的是「硅基流动（内置）」合作免费模型，与应用中另行提供的「免费模型试用」额度属于不同服务。请根据当前选择的服务商，查看对应的模型目录和使用说明，不要将两者的额度或规则混用。

个人 API Key 测试或对话失败怎么办？

先核对 API Key 是否完整、Base URL 是否为 https://api.siliconflow.cn/v1，以及模型 ID 是否正确。若返回 401，优先检查密钥；若返回 403，检查实名认证及访问权限；若返回 429，减少连续请求并稍后重试。涉及模型不可用、账号余额或其他提示时，以平台返回的具体错误信息为准。

更多说明见 硅基流动 API 请求错误排查。

已保存配置，为什么聊天仍在使用原来的模型？

保存服务商配置不等于切换当前对话模型。请在聊天页重新打开模型选择器，确认选择的是目标服务商及其模型。尤其在同时保留两个硅基流动入口时，应区分「硅基流动（内置）」与使用个人 Key 的「硅基流动」。