API Reference

This section provides API documentation for the Ticos platform, covering conversation summarization, voice capabilities, knowledge base, face management, and terminal control.

Authentication

Most endpoints require an API Key for authentication. You can pass it in one of the following ways:

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

Conversation & Summary

• Stardust Config — Conversation memory summarization (/summarize)
• Notify — Event notifications and pushes

Voice Capabilities

• TTS Voice Training — Create custom voices
• Speech Synthesis — Text-to-speech (REST)
• Voiceprint Management — Voice feature extraction and management
• Terminal TTS Control — Control robot announcements

Data & Configuration

• Knowledge Base — Document upload and RAG retrieval
• Variable Management — Global robot variable configuration
• Scenario Management — Scene conversation script flows

Biometrics

• Face Data Management — Face registration and search

Terminal Control

• Terminal Function Call — Issue commands to robots

Quick Start Example

Test the summarization endpoint using 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": "Hello, help me log today's greeting events." },
    { "role": "assistant", "content": "Sure, I will sync them to the daily report system." }
  ]
}'