发送消息

向指定的对话 ID 发送消息，并获取 Bot 响应信息。支持提交文本和/或图片作为消息内容。

请求方式

POST

调用地址

https://api.gptbots.ai/v1/conversation/message

调用验证

详情参见 API 概述的鉴权方式说明。

请求

请求示例

curl -X POST https://api.gptbots.ai/v1/conversation/message \ -H 'Authorization: Bearer your_apikey' \ -H 'Content-Type: application/json' \ -d '{ "text": "HI！", "conversation_id": "xxxxxx", "response_mode": "streaming", "short_term_memory": true, "long_term_memory": false, "files":[ { "url": "https://res.gptbots.cc/ailab/botchat/file/38f13465ad5246190b759b3289ecba51.jpg", "name": "something.jpg", "width": 200, "height": 200 }, { "base64_content": "Your_file_base64_content", "name": "something.pdf" } ], "knowledge": { "data_ids": [ "1111111111", "2222222222" ] } }'

          curl -X POST https://api.gptbots.ai/v1/conversation/message \ 
  -H 'Authorization: Bearer your_apikey' \ 
  -H 'Content-Type: application/json' \ 
  -d '{
        "text": "HI！",
        "conversation_id": "xxxxxx",
        "response_mode": "streaming",
        "short_term_memory": true,
        "long_term_memory": false,
        "files":[
          {
            "url": "https://res.gptbots.cc/ailab/botchat/file/38f13465ad5246190b759b3289ecba51.jpg",
            "name": "something.jpg",
            "width": 200,
            "height": 200
          },
          {
            "base64_content": "Your_file_base64_content", 
            "name": "something.pdf"
          }
        ],
        "knowledge": {
            "data_ids": [
                "1111111111",
                "2222222222"
            ]
        }
}'

此代码块在浮窗中显示

请求头

字段	类型	描述
Authorization	Bearer ${token}	使用 Authorization: Bearer ${token}进行调用验证，请在 API 密钥页面获取密钥作为 token。
Content-Type	application/json	数据类型，取值为 application/json。

请求体

字段	类型	必填	描述
text	string	是	text 与 files 必须至少输入其一，text 用于向 Bot 提交文本类型信息。所提交的文本内容不能超过 Bot 配置的 tokens 长度限制。
files	JSON Array	否	text 与 files 必须至少输入其一，files 用于向 Bot 提交图片、音频和文档类型数据。Bot 支持「系统文件识别」和「LLM 文件识别」2 种文件识别方案，不同的识别方案所支持的文件类型也各不相同。支持提交文件的网络路径，最多上传9个文件。文档≤20MB 、图片≤10MB、音频≤5MB LLM 文件识别所支持的文件类型取决于各 LLM 的能力，若是 flowbot 则取所有 LLM 支持文件类型的交集。系统文件识别由 GPTBots系统对上传的文件进行识别并转义为文字。文档类型：.pdf,.txt,.docx,.csv,.xlsx,.html,.c,.cpp,.java,.json,.md,.php,.pptx,.py,.rb,.tex,.css,.js,.ts,.xml 图片类型：.jpg,.jpeg,.png,.gif,.webp 音频类型：.mp3,.wav,.acc 文件提交规范 base64_content，string，文件流（与文件URL链接二选一） url，string，文件URL链接（与文件流二选一） name, string, 文件名 width，int，图片宽度（图片类型必填） height，int，图片高度（图片类型必填）
conversation_id	string	是	对话标识符，传入需要继续对话的 conversation_id。
response_mode	string	是	blocking：阻塞型，等待执行完毕后返回结果。（请求若流程较长可能会被中断）。 streaming：流式返回，基于 SSE（Server-Sent Events）实现流式返回。
short_term_memory	boolean	否	本次发送消息，是否携带对话内的短记忆作为上下文。若不填写，则遵循 Bot 的记忆设置。
long_term_memory	boolean	否	本次发送消息，是否携带对话内的长记忆作为上下文。若不填写，则遵循 Bot 的记忆设置。
knowledge	object	否	本次消息发送，在知识库检索中，仅检索该入参内定义的知识数据作为检索范围。
- data_ids	array	否	知识库检索的知识 ID。若不提交该参数，视为不限制检索范围，即查询整个 Bot 的所有知识文档。若提交该参数，且空数组，如`[]`，则视为不检索任何知识文档。若数组内有`data_ids`，则基于这些`data_ids`执行检索。

响应

响应示例

{ "message_id": "65a4ccfC7ce58e728d5897e0", "message_type": "ANSWER", "text": "Hi, is there anything I can help you?", "flow_output": [ { "content": "你好", "branch": "1", "from_component_name": "User Input" } ], "create_time": 1679587005, "conversation_id": "657303a8a764d47094874bbe" }

          {
  "message_id": "65a4ccfC7ce58e728d5897e0",
  "message_type": "ANSWER",
  "text": "Hi, is there anything I can help you?",
  "flow_output": [
    {
      "content": "你好",
      "branch": "1",
      "from_component_name": "User Input"
    }
  ],
  "create_time": 1679587005,
  "conversation_id": "657303a8a764d47094874bbe"
}

此代码块在浮窗中显示

成功响应（阻塞）

字段	类型	描述
message_id	string	消息的唯一标识。
message_type	string	消息类型，取值：ANSWER、QUESTION。
text	string	回复内容。
flow_output	JSON Array	flow bot 回复内容。
content	string	flow bot 组件回复内容。
branch	string	flow bot 分支。
from_component_name	string	flow bot 上游组件名称。
create_time	long	回复的这条消息产生的时间戳。
conversation_id	string	对话标识符。

成功响应（流式）

字段	类型	描述
code	int	消息的类型编码，3-文本类型、10-flowbot 输出、0-结束标识。
message	string	消息类型，取值：Text、FlowOutput、End。
data	object	回复内容。

流式数据分多次返回：

{"code":3,"message":"Text","data":"我"} {"code":3,"message":"Text","data":"可以"} {"code":3,"message":"Text","data":"帮"} {"code":3,"message":"Text","data":"助"} {"code":3,"message":"Text","data":"你"} {"code":3,"message":"Text","data":"的"} {"code":3,"message":"Text","data":"吗"} {"code":3,"message":"Text","data":"?"} {"code":10,"message":"FlowOutput","data":[{"content":"你好","branch":null,"from_component_name": "User Input"}]} {"code":0,"message":"End","data":null}

          {"code":3,"message":"Text","data":"我"}  
{"code":3,"message":"Text","data":"可以"}
{"code":3,"message":"Text","data":"帮"}  
{"code":3,"message":"Text","data":"助"}
{"code":3,"message":"Text","data":"你"}  
{"code":3,"message":"Text","data":"的"}
{"code":3,"message":"Text","data":"吗"}
{"code":3,"message":"Text","data":"?"}
{"code":10,"message":"FlowOutput","data":[{"content":"你好","branch":null,"from_component_name": "User Input"}]}
{"code":0,"message":"End","data":null}

此代码块在浮窗中显示

失败响应

字段	类型	描述
code	int	错误码。
message	string	错误详情。

错误码

Code	Message
40000	参数错误
40127	开发者鉴权失败
40356	会话不存在
50000	系统内部错误
40364	该 Bot 未使用支持图片模态的 LLM
20059	Bot 已删除
20040	超过问题长度限制
40358	conversation_id 无法匹配 Bot 或用户
20022	积分不足