Skip to main content

获取 Ace Data Cloud API Key

  1. 打开 控制台 → 应用列表,完成登录。
  2. 按计费方式选择应用:使用 Coding Plan 时进入 Coding Application;按量使用时选择有对应服务权限的通用/服务应用。Coding 套餐与通用余额分别管理。
  3. 复制该应用的 API Key / API Token,不要复制 Application ID 或 platform- 管理 Token。下文 API Key 字段只填写密钥本身,不含 Bearer 前缀。
  4. 确认应用有效且有额度。活动和免费额度以控制台实时显示为准。
用同一把 Key 查询模型目录:
PowerShell 环境变量写法为 $env:ACEDATACLOUD_API_KEY = "YOUR_ACEDATACLOUD_API_KEY";使用 Windows 自带 curl 时写 curl.exe/v1/models 是模型发现入口,目录中出现某个模型不等于当前 Key 有对应 API 权限。还要核对所选协议、应用范围和客户端能力。 下文 MODEL_ID 必须替换为具体模型 ID。不要把真实 Key 提交到 Git、贴进日志或截图。

1. 安装与版本

2026-09-07 npm 发布版为 0.23.0,该包要求 Node.js 22+。安装时以当前包的 engines 为准。

2. 用户级模型配置

合并到 ~/.qwen/settings.json
这是自定义 Provider ID;必须用 providerProtocol 映射到 openai。数组条目里的 id 才是真正发给平台的模型名,不要把别名 acedatacloud 填成模型。

3. 启动并选择模型

进入测试项目启动 qwen,用 /model 选择上面登记的模型,然后完成下方文件任务。需要无交互测试时:
如果没有选中预期配置,先回到 /model 确认 Provider 和模型,避免已有 OAuth 或同名 Provider 配置干扰。不要因为 Key 来自第三方就选择 Qwen OAuth 登录。 2026-09-07 使用 Qwen Code 0.23.0,在隔离配置目录加载上面的 JSON,执行上述无交互命令,实际返回 ADC_QWEN_OK,退出码 0。此项验证模型连接;下面的文件任务是进一步验收步骤。

实战与验收

先新建一个测试目录,在 fixture.txt 写入 hello from Ace Data Cloud,然后让客户端执行:
读取 fixture.txt,逐字引用其内容并解释文件用途。不要修改任何文件。
检查是否真的读取文件、是否引用正确内容;然后到 平台使用历史 按时间核对请求。对不支持文件工具的聊天模式,先附加该文件,再提同样的问题。不要用一次简单聊天成功推断编辑、图片、工具、自动补全全部可用。

核对依据

配置于 2026-09-07 对照下列官方资料核对;除明确列出的实测外,不把所有系统与客户端版本都标为已跑通。 返回 Coding Plan 配置中心