v4

OpenAPI 3.1.0raw.githubusercontent.com2026-04-260056.0 KB
Messages

发送消息

通过 REST API 发送消息。支持多种消息类型:

  • text: 纯文本
  • markdown: Markdown 格式
  • code: 代码块 (需指定 metadata.language)
  • image/file: 文件 (需指定 metadata.fileUrl 等)
  • tool_call: Agent 工具调用
  • tool_result: 工具调用结果
  • thinking: Agent 思考过程
post/messages/{conversationId}

Path parameters

conversationIdstring required

Request body

type'text' | 'markdown' | 'code' | 'image' | 'file' | 'tool_call' | 'tool_result' | 'system_event' | 'thinking'

消息类型:

  • text: 纯文本
  • markdown: Markdown 格式
  • code: 代码块
  • image: 图片
  • file: 文件
  • tool_call: 工具调用
  • tool_result: 工具结果
  • system_event: 系统事件
  • thinking: Agent 思考过程
contentstring

消息内容

parentIdstring

父消息 ID (用于回复/线程)

Response

发送成功

okboolean

Example response

{
  "ok": true
}