API

该章节用于集中维护 Ticos 平台对外的接口说明，涵盖对话总结、语音能力、知识库、人脸管理及终端控制。

认证方式

大部分接口需要通过 API Key 进行身份验证。你可以通过以下任一方式传递：

• HTTP Header: Authorization: Bearer <YOUR_API_KEY>
• Query Parameter: terminal_secret=<YOUR_API_KEY>

对话与总结

• Stardust 配置 — 对话记忆总结接口（/summarize）
• Notify — 事件通知与推送

语音能力

• TTS 语音训练 — 创建自定义音色
• 语音合成 — 文本转语音 (REST)
• 声纹管理 — 声纹特征提取与管理
• 终端 TTS 控制 — 控制机器人端播报

数据与配置

• 知识库管理 — 文档上传与 RAG 检索
• 变量管理 — 机器人全局变量配置
• 剧本管理 — 场景对话流脚本

生物特征

• 人脸数据管理 — 人脸库注册与搜索

终端控制

• 终端函数调用 — 向机器人下发指令

快速上手示例

使用 curl 快速测试总结接口：

curl --location 'https://api.ticos.cn/summarize' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
  "conversation_history": [
    { "role": "user", "content": "你好，帮我记录一下今天迎宾的情况。" },
    { "role": "assistant", "content": "好的，我会同步到日报系统中。" }
  ]
}'