ThinkWheel Docs
接入指南

鉴权说明

使用 access_key 校验应用身份和能力权限。

单密钥鉴权

创建应用时平台生成一个 access_key,无需 AppSecret、签名、时间戳或随机串。调用前请确保应用已启用,且已关联目标能力。创建和编辑应用均可多选能力,也可从能力卡片关联应用。

HTTP / HTTPS

每次请求通过 Authorization: Bearer <Access Key> 请求头携带完整密钥,不支持将 HTTP 密钥放入 URL。

POST /openapi/v1/?model=education-ocr
Authorization: Bearer <你的完整 Access Key>
Content-Type: application/json

请求体和业务参数遵循实际能力接口要求。生产环境使用 HTTPS,并将密钥保存于业务服务端的环境变量或密钥管理系统中。

权限结果

  • 401:密钥缺失、无效、重复,或对应应用已删除。
  • 403:应用已停用,或没有绑定请求能力。
  • 503:目标能力尚未配置业务上游。

取消能力绑定或停用应用后,后续请求立即拒绝;已开始的 SSE 流不会在中途重新鉴权。

控制台的管理接口仍使用用户 JWT,与能力调用的 access_key 分开。

On this page