认证 · Evose

Evose API 用 Bearer Token 认证。Token 来自组织级 API Key。

创建 API Key

[组织管理 · API 管理] → 新建 API Key:

Key 仅显示一次

创建后的完整 Key 仅在创建瞬间可见，关闭对话框后无法再次查看。请立即妥善保存。

每个请求带 Authorization 头:

Authorization: Bearer evk_xxxxxxxxxxxxxxxxx

最小权限原则

给业务系统的 Key 只授必要作用域。线上后端需调 Agent → 仅授 agent:invoke。

部分场景需要前端直接调用（如 JS SDK),使用公钥:

Authorization: Bearer pub_xxxxxxxxxxxxxxxxx

公钥:

调用时需指明最终用户(用于审计、归因、ACL 检查):

{
  "message": "...",
  "user_id": "u-internal-id",
  "user_name": "张三",
  "user_email": "zhangsan@example.com"
}

建议轮换周期：90 天。强合规场景：30 天。