创建会话

更新于 2026-01-13

该接口用于创建会话并返回 conversationId，后续聊天请求需携带该会话标识。

接口调用

说明

接口描述 与AI应用进行聊天之前，需要创建对应的会话
请求域名 https://openapi.jbangai.com
接口地址 /api/v1/bot/{key}/conversation
请求方式 POST
权限校验 是

提交参数

Header请求头

参数 类型 是否必传 参数说明
Access-Token string 是 从 获取令牌 中获取到对应的参数值 accessToken，详情请查看文档

Path参数

参数 类型 是否必传 参数说明
key string 是 应用 key 值，由匠邦 AI 提供

请求示例

curl --location --request POST 'https://openapi.jbangai.com/api/v1/bot/{key}/conversation' \
  --header 'Access-Token: eyJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJvcGVuLWFwaSIsImlhdCI6MTc0MDY2NDA5OCwiZXhwIjoxNzQwNjcxMjk4fQ.dG9rZW5fZXhhbXBsZV9zaWduYXR1cmU' \
  --header 'Content-Type: application/json' \
  --header 'Accept: */*' \
  --header 'Host: ai-user-api.jbangai.com' \
  --header 'Connection: keep-alive' \
  --data-raw '{
    "deployId": "90x33rl"
  }'

返回参数

参数 子参数 类型 说明
code — string 响应编码
data conversationId string 创建会话成功之后，生成的会话ID，用于聊天请求
message — string 返回提示信息
serverTime — string 当前时间戳

响应示例

{
  "code": 0,
  "data": {
    "conversationId": "y6pl1d68"
  },
  "message": "",
  "serverTime": 1740664098
}