Skip to content
Ticos Docs

Stardust Configuration

Basics

  • Endpoint: POST https://api.ticos.cn/summarize
  • Content-Type: application/json

Authentication (choose one)

  • Header: Authorization: Bearer <API_KEY>
  • Query: terminal_secret=<API_KEY>

Request body

{
  "conversation_history": [
    {
      "role": "user|assistant|system",
      "content": "actual dialogue between the robot and users",
      "timestamp": "2026-02-25T12:34:56Z"
    }
  ],
  "parameters": {
    "max_length": 512,
    "language": "en-US",
    "history_in_conversation": true,
    "summarize_prompt": "Update long-term service memory using {{latest_memory}} and {{conversation}}.",
    "latest_memory": "Robot serves at a community store with focus on elderly-friendly assistance"
  }
}

Field notes

  • conversation_history (required)
  • role: user / assistant / system
  • content: message text (simple Markdown supported)
  • timestamp: ISO 8601 (optional)
  • parameters (optional)
  • max_length: max summary length (default: 200)
  • language: output language (default: en-US)
  • history_in_conversation: whether to include key-point style output (default: false)
  • summarize_prompt: custom prompt template
  • latest_memory: previously stored memory to be merged

Success response

{
  "summary": "The robot should improve elevator guidance during reception and keep assisting slow-walking elderly visitors."
}

Error codes

  • 400: invalid request body
  • 429: rate limited
  • 500: internal server error

Example request

curl --location 'https://api.ticos.cn/summarize' \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
  "conversation_history": [
    {
      "role": "user",
      "content": "Several visitors asked where the elevator is today."
    },
    {
      "role": "assistant",
      "content": "I will mention elevator directions earlier in my greeting flow."
    },
    {
      "role": "user",
      "content": "One elderly visitor moved slowly, please keep this in memory."
    }
  ],
  "parameters": {
    "max_length": 256,
    "language": "en-US",
    "history_in_conversation": true,
    "latest_memory": "Robot handles reception and basic assistance at a community store"
  }
}'

Optional query parameter

  • agent_id: can be appended to /summarize