Skip to content

访问首页 ​

  • 接口地址: /

  • 请求方式: GET

  • 接口描述: 返回AI智能伴侣的前端页面

  • 请求参数: 无

  • 请求示例: /

  • 响应参数: 返回 index.html 静态页面 (Content-Type: text/html)


获取伴侣预设列表 ​

  • 接口地址: /api/presets

  • 请求方式: GET

  • 接口描述: 获取所有AI伴侣预设数据,前端用于渲染预设选择下拉框

  • 请求参数: 无

  • 请求示例: /api/presets

  • 响应参数:

内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_F8vS1J

  • 响应示例:
json
{
    "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

  • 请求示例:
python
{
    "nick_name": "小甜甜",
    "nature": "活泼开朗的东北姑娘,说话直爽,爱唠嗑,带点大碴子味儿,特别热情暖心"
}
  • 响应参数:

内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_tBzPuV

  • 响应示例:
python
{
    "code": 200,
    "message": "创建会话成功",
    "data": "2026-05-29_15-30-00"
}

AI对话 ​

  • 接口地址: /api/chat

  • 请求方式: POST

  • 接口描述: 与AI伴侣进行对话,服务端会自动加载该会话的历史消息,并调用DeepSeek大模型生成回复。每次对话会自动保存到会话文件中。

  • 请求参数:

内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_m1KIEu

  • 请求示例:
json
{
    "session_name": "2026-05-25_10-47-15",
    "message": "今天心情不太好",
    "nick_name": "小甜甜",
    "nature": "活泼开朗的东北姑娘,说话直爽,爱唠嗑,带点大碴子味儿,特别热情暖心"
}
  • 响应参数:

内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_U3ZFWO

  • 响应示例:
python
{
    "code": 200,
    "message": "请求成功",
    "data": "咋滴啦大兄弟?有啥不开心的跟姐说说,别憋着!🌸"
}

获取会话列表 ​

  • 接口地址: /api/sessions

  • 请求方式: GET

  • 接口描述: 获取所有会话列表,按时间降序排列 (最新的会话排在最前)

  • 请求参数: 无

  • 请求示例: /api/sessions

  • 响应参数:

内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_DcKYKL

  • 响应示例:
json
{
    "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

响应示例:

json
{
    "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

  • 响应示例:
python
{
    "code": 200,
    "message": "删除会话成功",
    "data": null
}

附录: 通用说明 ​

状态码说明 ​

内嵌电子表格(v1 不转换),token: TOFMsLihZhntaOtYpxEctQGrns5_yAgr1M

统一响应格式 ​

所有API接口均返回以下统一格式:

python
{
    "code": 200,
    "message": "提示信息",
    "data": null
}
  • code: 状态码 (integer),200 表示成功

  • message: 提示信息 (string)

  • data: 响应数据 (any),具体结构见各接口定义