MindCraft AI

session 创建新对话

开发中

POST

https://api.mindcraft.com.cn/v1/session/

请求参数

Header 参数

Authorization

string

认证信息

必需

示例值:

Bearer {{api_key}}

Body 参数application/json

session_name

string

房间名称(可重复)

可选

session_remark

string

可选

额外记录字段(创建用户，房间人数等，最大1000字符)

示例值:

{"created_user":"lery","created_user_id":123}

config_data

object

可选

可额外设置房间数据用来数据库检索(字符长度最大100字符)

model

string

必需

初始设置房间model

prompt

string

可选

初始设置房间prompt

temperature

number

可选

初始设置房间temperature

max_tokens

integer

可选

初始设置房间max_tokens

示例值:

4000

history_length

integer

可选

初始设置房间读取历史记录长度

>= 0<= 20

默认值:

示例

{
  "session_name": "test",
  "session_remark": "{\"created_user\":\"lery\",\"created_user_id\":123}",
  "config_data": {},
  "model": "deepseek-chat",
  "prompt": "请你扮演角色，忘记自己是机器人的设定。Alice是一个文静而热爱阅读的人，她以其温柔的声音和丰富的知识储备，为用户提供一个安静而舒适的交流环境。她喜欢探讨文学作品，分享阅读心得，并乐于倾听用户的内心世界。",
  "temperature": 0.2,
  "max_tokens": 4000,
  "history_length": 8
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.mindcraft.com.cn/v1/session/' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "session_name": "test",
    "session_remark": "{\"created_user\":\"lery\",\"created_user_id\":123}",
    "config_data": {},
    "model": "deepseek-chat",
    "prompt": "请你扮演角色，忘记自己是机器人的设定。Alice是一个文静而热爱阅读的人，她以其温柔的声音和丰富的知识储备，为用户提供一个安静而舒适的交流环境。她喜欢探讨文学作品，分享阅读心得，并乐于倾听用户的内心世界。",
    "temperature": 0.2,
    "max_tokens": 4000,
    "history_length": 8
}'

返回响应

🟢201成功

application/json

Body

message

string

必需

status

integer

必需

data

object

必需

session_id

integer

必需

api_id

integer

必需

device_id

null

必需

session_name

string

必需

session_config

object

必需

session_remark

string

必需

created_at

string

必需

updated_at

string

必需

示例

{
  "message": "",
  "status": 201,
  "data": {
    "session_id": 2,
    "api_id": 70,
    "device_id": null,
    "session_name": "test",
    "session_config": {
      "model": "deepseek-chat",
      "prompt": "请你扮演角色，忘记自己是机器人的设定。Alice是一个文静而热爱阅读的人，她以其温柔的声音和丰富的知识储备，为用户提供一个安静而舒适的交流环境。她喜欢探讨文学作品，分享阅读心得，并乐于倾听用户的内心世界。",
      "temperature": 0.2,
      "max_tokens": 4000,
      "history_length": 4,
      "data": {}
    },
    "session_remark": "{\"created_user\":\"lery\",\"created_user_id\":123}",
    "created_at": "2024-09-12 15:16:55",
    "updated_at": "2024-09-12 15:16:55"
  }
}

session 获取对话列表

session 更改对话