TokenAgents / API Docs

创建聊天会话

根据首条用户消息与模型参数创建一个新的聊天会话记录。

POST/api/chat/newChat API

创建聊天会话

根据首条用户消息与模型参数创建一个新的聊天会话记录。

鉴权方式

需要登录态 Cookie，未登录会直接返回错误。

调试方式

所有页面都提供 shell curl 模板，方便你直接复制联调。

适配模型

当前页已关联 4 个模型目录，和前端实际可选模型保持同步。

请求体

当前接口支持的请求字段如下。

字段	类型	必填	说明
message.text	string	是	首条用户输入文本。
body.model	string	是	本次会话选中的模型 ID。
body.reasoning	boolean	否	可选的会话元数据，会写入 metadata。
body.webSearch	boolean	否	可选的会话元数据，会写入 metadata。

成功返回

使用当前接口时，可参考以下返回说明。

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "id": "{{chatId}}",
    "title": "首条消息的前 100 个字符",
    "model": "openai/gpt-5",
    "provider": "openrouter"
  }
}

关联模型

当前接口支持的模型目录。

Kimi K2 Thinking Deepseek R1 GPT-5 Claude 4.5 Sonnet

Shell 调用示例

复制下面的 curl 模板，替换占位变量后即可联调。

curl

curl -X POST "{{baseUrl}}/api/chat/new" \
  -H "Content-Type: application/json" \
  -H "Cookie: {{sessionCookie}}" \
  -d '{
    "message": {
      "text": "帮我创建一个新的品牌文案会话"
    },
    "body": {
      "model": "openai/gpt-5",
      "reasoning": false,
      "webSearch": false
    }
  }'

调用说明

• 当前 provider 在代码里固定为 openrouter。
• title 会从首条 message.text 截取前 100 个字符。