认证

Bearer 认证

Authorization: Bearer YOUR_API_KEY

在设置 → API 密钥中创建新密钥。新密钥使用加密随机数，数据库保存摘要，仅首次展示；列表页无法恢复原密钥。

更新旧密钥

API 上线前的密钥返回 403 api_key_upgrade_required。请创建新密钥、更新服务端配置，再撤销旧密钥。每账户最多 10 枚有效密钥，每小时创建 10 枚、每天 20 枚。

仅服务端使用

携带 Origin 头的请求会被拒绝。不要将密钥放在 URL、提示词、前端代码、移动端程序、日志、代码仓库或导出工作流中。请使用服务端密钥管理工具或 n8n Credential。

撤销与任务归属

泄露后立即撤销。重试和查询需要原 API 密钥；即使是同账户的另一枚密钥，也不能通过 API 查询该任务。撤销不会取消已经提交的任务。