AGENT API 认证：Bearer 与 ApiKey

咏唱引擎的 AGENT API 用 Authorization 头认证。网关接受 Bearer 或 ApiKey，密钥值相同。具体行为取决于服务端启动时是否设置了 AGENT_CLOUD_API_KEY。

支持的方案

curl https://agent.ariacompute.cn/v1/agents \
  -H "Authorization: Bearer <api_key>"

curl https://agent.ariacompute.cn/v1/agents \
  -H "Authorization: ApiKey <key>"

海外站点把主机换成 https://agent.ariacompute.com。

自助密钥的作用域有 read、write、admin，admin 隐含读写。创建、列出与吊销密钥需要 admin 作用域，见创建 / 列出与吊销。

需要认证但密钥缺失或无效时，API 返回 401。应用错误使用 OpenAI 形态的信封：

{
  "error": {
    "message": "Unauthorized",
    "type": "401 Unauthorized"
  },
  "message": "Unauthorized"
}