API Key 与权限

在 Console 密钥管理 创建或使用已有的统一 API Key。推荐使用自动渠道（auto_channels），不绑定 Group，不添加渠道限制。图片、视频、音乐公开接口要求这样的统一 Key；LLM 专用分组或限定渠道 Key 不适用于此教程。

账户需要启用且有可用资金的 USD 钱包；Key 必须有效、未过期、未撤销，同时总额度和时间窗口额度须有余量。账户钱包承担实际费用，Key 限额控制这个 Key 能消费多少，二者不是同一个余额。无限额 Key 也需要支付实际费用，无法绕过钱包余额限制。LLM 和媒体共用同一 Key 的消费限额，正在处理的任务也会占用预算。

已有 Key 能用时直接使用，不必为重复示例新增 Key、重置额度或增加资金。若需新建，请参考 创建 API Key。把原始 Key 存在本机私有文件并 chmod 600，不要公开它，也不要放入 URL、Git 或日志。

所有 API 请求使用：

Authorization: Bearer YOUR_API_KEY

接口基地址是 https://api.uniroute.app。完整的无明文 Key 命令行示例见 快速开始。API 响应里的公共文件/CDN URL 下载不需要认证，必须使用独立请求，不能携带或转发 Bearer。

任务查询、历史和幂等重放都按创建任务的同一 Key隔离。另一个 Key，即使属于同一账户，也不能访问该任务，查询返回 404。撤销 Key 后 API 返回 401；撤销不会删除已受理任务的费用或未完成结算义务。

不要通过新 Key 或重新创建任务解决未知账单。保留任务 ID、幂等键和原请求，使用原 Key 查询或联系支持。详见 计费与恢复。