AGENT API 认证：Bearer 与 ApiKey

使用 Bearer 令牌或 ApiKey 头认证 AGENT API 请求。当 AGENT_CLOUD_API_KEY 在服务端启动时未设置时，认证是可选的。

咏唱引擎的 AGENT API 支持两种基于请求头的认证方案。只有当 AGENT_CLOUD_API_KEY 在服务端启动时被设置时，才会强制认证。当它未设置时，接口开放，不需要 Authorization 头。

支持的方案

你可以在 Authorization 头中使用 Bearer 或 ApiKey。两者接受相同的 API 密钥值。

方案 1：Bearer

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

方案 2：ApiKey

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

在这两个示例中，请将 <api_key> 替换为你的自助 API 密钥。

自助 API 密钥

通过调用 /v1/api-keys 接口生成与轮换密钥。你可以创建多个密钥并独立吊销它们。

错误响应

若需要认证时密钥缺失或无效，API 返回 401，响应体为：

{
  "error": "Unauthorized"
}