获取 Ace Data Cloud API Key
- 打开 控制台 → 应用列表，完成登录。
- 按计费方式选择应用：使用 Coding Plan 时进入 Coding Application；按量使用时选择有对应服务权限的通用/服务应用。Coding 套餐与通用余额分别管理。
- 复制该应用的 API Key / API Token，不要复制 Application ID 或
platform-管理 Token。下文 API Key 字段只填写密钥本身，不含Bearer前缀。 - 确认应用有效且有额度。活动和免费额度以控制台实时显示为准。
$env:ACEDATACLOUD_API_KEY = "YOUR_ACEDATACLOUD_API_KEY"；使用 Windows 自带 curl 时写 curl.exe。/v1/models 是模型发现入口，目录中出现某个模型不等于当前 Key 有对应 API 权限。还要核对所选协议、应用范围和客户端能力。
下文 MODEL_ID 必须替换为具体模型 ID。不要把真实 Key 提交到 Git、贴进日志或截图。
1. 确认你使用的入口
本页适用于扣子编程的 AI 编程项目 → 模型列表 → 添加自定义模型。官方文档目前说明需个人进阶版及以上，企业成员可添加、共享受管理员控制。以当前账号与组织权限为准。 不要混用另一篇“低代码项目 → 企业组织管理 → 模型接入”的表单：该入口的套餐、协议与空间授权流程不同。2. 填写自定义接入表单
- 在扣子编程首页打开 模型列表 → 添加自定义模型。
- 选择 自定义接入，填写下表。
- 核对最大输入/回复长度；图片理解只在模型实际支持时开启。
- 点击 添加，回到模型列表选择新模型。
官方表单的 API URL 是 Base URL，会按协议拼接路径；本例最终目标为
https://api.acedata.cloud/v1/chat/completions。不要在 Base URL 里重复填写完整路径。
3. 做一次编程任务
先发送Reply only ADC_COZE_OK，再让它读取项目说明文件并总结。确认流式回复、工具结果回传正常，并到平台使用历史对照。某一协议测试成功不能替代另外两种协议的验证。
若看不到该协议选项，先检查是否进入了低代码企业模型表单、区域/版本和账号权限；不要强行套用另一个入口。
实战与验收
先新建一个测试目录，在fixture.txt 写入 hello from Ace Data Cloud，然后让客户端执行：
读取 fixture.txt，逐字引用其内容并解释文件用途。不要修改任何文件。检查是否真的读取文件、是否引用正确内容；然后到 平台使用历史 按时间核对请求。对不支持文件工具的聊天模式，先附加该文件，再提同样的问题。不要用一次简单聊天成功推断编辑、图片、工具、自动补全全部可用。