接入指南
鉴权说明
使用 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 分开。