获取 Agent 列表

获取平台提供的所有可用语音Agent列表，包括语音Agent的基本信息、角色介绍和适用场景。支持分页查询。

GET /v1/realtime/agents

获取 Agent 列表

cURL

curl --request GET \
  --url https://api.senseaudio.cn/v1/realtime/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>'

200

Example

{
  "total": 10,
  "list": [
    {
      "id": "690f53770e9d9d60d98ba7a8",
      "title": "今天天气怎么样",
      "avatar": "https://example.com/avatar1.jpg",
      "intro": "今天天气怎么样"
    },
    {
      "id": "8bb494d52b152690f2ff6c58",
      "title": "今天天气怎么样",
      "avatar": "https://example.com/avatar2.jpg",
      "intro": "今天天气怎么样"
    }
  ]
}

授权

Authorization · string · header · 必填

格式：Bearer <API_KEY>

请求头

Content-Type · string · 默认值: application/json · 必填

内容类型。固定为 application/json

示例:

"application/json"

查询参数

page · integer · 默认值: 1

分页页码

示例:

1

size · integer · 默认值: 10

每页数量

示例:

10

响应

200

application/json

成功响应

list · object[]

Agent 列表

Show child attributes

total · integer

总数