访问首页
接口地址:
/请求方式:
GET接口描述: 返回AI智能伴侣的前端页面
请求参数: 无
请求示例:
/响应参数: 返回
index.html静态页面 (Content-Type: text/html)
获取伴侣预设列表
接口地址:
/api/presets请求方式:
GET接口描述: 获取所有AI伴侣预设数据,前端用于渲染预设选择下拉框
请求参数: 无
请求示例:
/api/presets响应参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_F8vS1J
- 响应示例:
{
"code": 200,
"message": "获取预设列表成功",
"data": [
{
"id": 1,
"name": "东北甜妹",
"nick_name": "小甜甜",
"nature": "活泼开朗的东北姑娘,说话直爽,爱唠嗑,带点大碴子味儿,特别热情暖心",
"sort_order": 1
},
{
"id": 2,
"name": "温柔御姐",
"nick_name": "诗涵",
"nature": "温柔体贴的南方姑娘,知性优雅,说话轻声细语,善解人意,很会照顾人",
"sort_order": 2
}
]
}创建新会话
接口地址:
/api/sessions请求方式:
POST接口描述: 创建一个新的聊天会话,自动生成会话名称
请求参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_xXiI8B
- 请求示例:
{
"nick_name": "小甜甜",
"nature": "活泼开朗的东北姑娘,说话直爽,爱唠嗑,带点大碴子味儿,特别热情暖心"
}- 响应参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_tBzPuV
- 响应示例:
{
"code": 200,
"message": "创建会话成功",
"data": "2026-05-29_15-30-00"
}AI对话
接口地址:
/api/chat请求方式:
POST接口描述: 与AI伴侣进行对话,服务端会自动加载该会话的历史消息,并调用DeepSeek大模型生成回复。每次对话会自动保存到会话文件中。
请求参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_m1KIEu
- 请求示例:
{
"session_name": "2026-05-25_10-47-15",
"message": "今天心情不太好",
"nick_name": "小甜甜",
"nature": "活泼开朗的东北姑娘,说话直爽,爱唠嗑,带点大碴子味儿,特别热情暖心"
}- 响应参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_U3ZFWO
- 响应示例:
{
"code": 200,
"message": "请求成功",
"data": "咋滴啦大兄弟?有啥不开心的跟姐说说,别憋着!🌸"
}获取会话列表
接口地址:
/api/sessions请求方式:
GET接口描述: 获取所有会话列表,按时间降序排列 (最新的会话排在最前)
请求参数: 无
请求示例:
/api/sessions响应参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_DcKYKL
- 响应示例:
{
"code": 200,
"message": "获取会话列表成功",
"data": [
"2026-05-25_10-47-15",
"2026-04-27_14-45-33",
"2026-04-27_14-22-06"
]
}获取指定会话
接口地址:
/api/sessions/{session_name}请求方式:
GET接口描述: 获取指定会话的详细信息,包括聊天记录、伴侣设置等
请求参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_PhVJto
请求示例:
/api/sessions/2026-05-25_10-47-15响应参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_D9yWZx
响应示例:
{
"code": 200,
"message": "获取会话信息成功",
"data": {
"nick_name": "小甜甜",
"nature": "活泼开朗的东北姑娘,说话直爽,爱唠嗑,带点大碴子味儿,特别热情暖心",
"session_name": "2026-05-25_10-47-15",
"messages": [
{
"role": "user",
"content": "你好呀"
},
{
"role": "assistant",
"content": "嗨~你来啦!今天想聊点啥呀?🌸"
}
]
}
}删除会话
接口地址:
/api/sessions/{session_name}请求方式:
DELETE接口描述: 删除指定的会话及其所有聊天记录
请求参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_XHqKUt
请求示例:
DELETE /api/sessions/2026-05-25_10-47-15响应参数:
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_Mm5vbs
- 响应示例:
{
"code": 200,
"message": "删除会话成功",
"data": null
}附录: 通用说明
状态码说明
内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_yAgr1M
统一响应格式
所有API接口均返回以下统一格式:
{
"code": 200,
"message": "提示信息",
"data": null
}code: 状态码 (integer),200 表示成功message: 提示信息 (string)data: 响应数据 (any),具体结构见各接口定义
