REST API 文档
智元开放平台 HTTP REST API 接口文档。
通用响应格式
多数接口返回统一封装:
{ "code": 0, "success": true, "message": "", "data": {} }
人脸接口(Agent Face)不返回 success 字段,格式为:
{ "code": 0, "message": "success", "data": {} }
code === 0表示成功;非 0 为业务错误码message为错误提示data为业务数据,结构随接口不同;无返回数据的接口为null
在线调试
接口为静态文档,按页面中的请求参数与调用示例调用即可。
可用服务
人脸信息管理
提供人脸与声纹素材的上传、注册、绑定到智能体和按条件删除能力。
- 查询组织智能体列表 —
POST /api/V1/open-portal/app/linksoul/agent-faces/agent-list - 一步完成上传、注册与多智能体绑定 —
POST /api/V1/open-portal/app/linksoul/agent-faces/registration-bindings(推荐,单次调用) - 获取人脸素材上传地址 —
POST /api/V1/open-portal/app/linksoul/agent-faces/upload-urls - 上传素材到 TOS 对象存储 —
PUT <upload_url>(TOS 预签名直传) - 注册人脸与声纹 —
POST /api/V1/open-portal/app/linksoul/agent-faces/registrations - 绑定人脸到智能体 —
POST /api/V1/open-portal/app/linksoul/agent-faces/bindings - 删除人脸与声纹 —
POST /api/V1/open-portal/app/linksoul/agent-faces/deletions
知识库管理
提供基于智能体的知识库检索能力,支持从指定智能体关联的知识库中查询文档片段与问答内容,适用于智能问答、RAG 检索、知识库召回等场景。
- 按智能体检索知识库 —
POST /api/V1/open-portal/app/retriever/search/agent_kb