appidstring必填青鸾实例 ID，形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"发送图片
发送图片。先调「上传图片」，把返回的 data 整体作为 content 传入 —— 两边字段逐个对应，不需要自己拼。
POST
/qingluan/api/message/sendImage接口说明
发送图片。先调「上传图片」，把返回的 data 整体作为 content 传入 —— 两边字段逐个对应，不需要自己拼。
请求参数
请求体必填。通过 QL-Key 请求头携带 APIKey。
Content-Type：application/json
请求参数。字段名区分大小写，请按文档原样传递。
conversationIdint64必填会话 ID
会话 ID。群聊传群号，私聊传对方 uin。注意它超出 JavaScript 安全整数范围，JS 侧需按大整数处理，不要经过 Number()。
7881000000000002contentobject必填内容
「上传图片」返回的 data 整体。
idstring必填对象 ID。发消息返回时即 serverMsgId（撤回要用）；上传返回时即 fileId（发送/下载要用）；列表项中为该条记录 ID
字段示例："<sample-media-id>"sizeint64必填文件字节数。由上传接口返回
最小值：0
字段示例：10528widthint64必填图片/视频宽度（像素）
最小值：0
字段示例：284heightint64必填图片/视频高度（像素）
最小值：0
字段示例：177aesKeystring必填媒体解密密钥
媒体解密密钥。由上传接口返回，发送/下载时原样回传，不要改写
字段示例："ef9c3132a4790b0b6c711198e355823e"md5string必填MD5 校验值
文件 MD5。由上传接口返回，可用于校验
字段示例："065954fddfa288194a56407d279b4aac"midImageFileSizeint64必填中等尺寸图字节数
注意：随上传回执一起带上即可通过。它与 thumbFileSize 的差别（中图 vs 缩略图各自的字节数）未做单独验证，建议原样透传上传回执，不要自行计算。
0
字段示例：11338thumbFileSizeint64必填缩略图字节数
最小值：0
字段示例：11338thumbWidthint64必填缩略图宽度
最小值：0
字段示例：240thumbHeightint64必填缩略图高度
最小值：0
字段示例：149thumbMd5string必填缩略图 MD5
注意：契约示例把该字段的值写成了一个图片 URL，是错的。不传该字段照样发送成功，属非必填。缩略图相关真正需要的是 thumbFileSize/thumbWidth/thumbHeight。
"16a7677492f36683af5c3eef54d939bd"响应与结果确认
本接口为能力层原样返回，不统一增加青鸾外层信封。code = 0 仅表示请求被接受，不保证副作用已完成。
发送后通过拉取消息复核。超时或网络中断时，先确认结果，再决定是否重试，避免重复消息。
响应字段与 HTTP 状态
HTTP 200
能力层原样返回；code = 0 仅表示请求已受理，业务结果须按接口说明确认。
application/json
查看响应字段定义
接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断：HTTP 200 只表示请求已送达，成功以 code = 0 为准。
codeinteger必填业务状态码
业务状态码：0 表示成功，-1 表示失败；失败原因见 message。
0dataobject可选业务数据
业务返回数据；字段结构见下方定义。
idint64可选对象 ID。发消息返回时即 serverMsgId（撤回要用）；上传返回时即 fileId（发送/下载要用）；列表项中为该条记录 ID
syncKeyint64可选同步游标
同步键。下次增量同步传回
messageTypeint64可选消息类型枚举（0=普通消息）
fromUserIdint64可选发送方 ID
toUserIdint64可选接收方 ID
roomIdint64可选群聊 ID
群聊 ID。可从创建群、群列表、群详情或回调事件中获取。
contentTypeint64可选内容类型。0=文本 14=图片（完整枚举见平台「企微错误码」章节）
sendTimeint64可选发送时间戳（秒）
appInfostring可选企微内部应用标识，透传字段，无需处理
senderNamestring可选消息发送名称
contentobject可选内容
消息/动态正文。纯文本类接口传字符串；媒体类传对象（把上传接口返回的 data 整体带上）
idstring可选对象 ID。发消息返回时即 serverMsgId（撤回要用）；上传返回时即 fileId（发送/下载要用）；列表项中为该条记录 ID
sizeint64可选文件字节数。由上传接口返回
最小值：0widthint64可选图片/视频宽度（像素）
最小值：0heightint64可选图片/视频高度（像素）
最小值：0md5string可选MD5 校验值
文件 MD5。由上传接口返回，可用于校验
midImageFileSizeint64可选中等尺寸图字节数
最小值：0thumbFileSizeint64可选缩略图字节数
最小值：0thumbWidthint64可选缩略图宽度
最小值：0thumbHeightint64可选缩略图高度
最小值：0thumbMd5string可选缩略图 MD5
detailstring可选错误详情
错误详情；无补充信息时通常为空字符串。
messagestring必填响应消息
业务结果消息。成功通常为 ok；企微错误通常为 错误码|错误信息。
"ok"timestring必填服务端时间
服务端时间，格式为 YYYY-MM-DD HH:mm:ss。
"2026-07-21 07:33:17"HTTP 403
受控接口，需通过控制台配置
HTTP 404
appid 不存在或无权访问