第十章：配置 API

我们不面向中国境内公众提供 AI 生成服务；只与机构、企业、院校开展合作。

AI 生成功能（图像 / 视频 / 音乐 / 视觉理解 / 文本处理）本身不消耗你安装软件的费用，但每次调用背后都需要一个 AI 服务商 提供算力，这部分是按量计费的。API One——它是官方提供、开箱即用、价格透明的渠道。

API One 是什么

API One 是一个统一的 AI 内容生成 API 平台，一个账号即可调用语言模型（LLM）、图像生成、视频生成等多种模型，接口兼容 OpenAI 格式。

• 官网 / 控制台地址：https://apione.org
• baseURL：https://apione.org/v1（软件已经自动填写好）
• 鉴权方式：在请求头中携带 API Key（形如 Authorization: Bearer sk-xxxxxxxxxxxx）——这一层细节软件会替你自动处理，你只需要拿到 Key 并粘贴进设置即可。

第一步：注册账号并获取 API Key

1. 打开浏览器访问 https://apione.org 注册一个账号；
2. 登录后进入控制台的 「API 令牌」 页面；
3. 创建一个新的令牌（Key），复制生成的字符串（形如 sk-xxxxxxxxxxxx）——这就是你要粘贴进软件里的 API Key。

也可以直接从软件顶部标题栏的 「$ 点击获取API密钥」 按钮跳转过去，这个按钮在你还没配置任何 Key 时会一直显示。

第二步：账户充值

API One 按调用量计费，令牌里需要有余额才能正常生成。请在控制台的充值页面按需充值——具体额度可以对照控制台里各模型的价格说明来估算。您也可以通过购买和延长xushu.cc会员来获得赠送tokens，最多返100%。

第三步：在软件内配置

1. 点击软件顶部的齿轮图标打开设置；
2. 切换到 「API 配置」 标签页；
3. 如果服务商列表里还没有 API One，从 「添加更多」 下拉菜单中选择「API One」（它在推荐列表里通常排在第一位，标注为「性价比高、稳定」）；
4. 在右侧详情面板中：

• API Key：粘贴第一步获取的密钥（该输入框会做密码遮罩，且已禁用浏览器自动填充，避免误填其他账号密码）；

1. 点击 「保存」 按钮，软件会验证密钥有效性并自动拉取当前可用的模型列表；
2. 检测通过后，即可在各个 AI 生成节点的「模型」下拉框中看到 API One 提供的模型。

如果你不想每次新建节点都手动选择平台/模型，可以在 设置 → 模型偏好 中把 API One 的某个模型设为默认。

余额、流畅度与任务日志（在软件里随时可查）

配置成功后，顶部标题栏会常驻显示：

• 余额芯片：实时余额（每 60 秒自动刷新一次，悬停可看等值人民币提示）；
• 「查看流畅度」：悬浮查看各模型当前的拥堵/流畅状态，方便你在多个可选模型之间挑一个当下比较空闲的；
• 「任务日志」：点击跳转到 apione.org 的用量日志页面，可以查看每一次生成任务的详细记录与消耗。

关于异步任务（了解即可，软件已自动处理）

图像 / 视频 / 音乐这类生成任务在 API One 侧是异步处理的：提交任务后先拿到一个任务 ID，再轮询查询接口直到任务完成、取回结果链接（结果链接有效期 24 小时）。这一整套「提交 → 轮询 → 取结果」的流程，软件内部已经封装好，你在生成节点上看到的「进度条 / 进度阶段」就是这个轮询过程的可视化，不需要你手动处理。

常见错误对照表

如果生成失败，节点上出现的错误提示大多可以对照下表定位原因：