appidstring必填青鸾实例 ID，形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"上传视频
上传视频。base64 必须是结构完整的 mp4（缺 moov 元数据盒会被拒绝），thumbBase64 是封面图的 base64，width / height 必填。
POST
/qingluan/api/cdn/uploadVideo接口说明
上传视频。base64 必须是结构完整的 mp4（缺 moov 元数据盒会被拒绝），thumbBase64 是封面图的 base64，width / height 必填。
请求参数
请求体必填。通过 QL-Key 请求头携带 APIKey。
Content-Type：application/json
请求参数。字段名区分大小写，请按文档原样传递。
base64string必填视频内容的 base64（不含 data: 前缀）。必须是结构完整的 mp4 —— 缺 moov 元数据盒的文件会被拒绝。
"AAAAHGZ0eXBtcDQyAAAAAWlzb21tcDQxbXA0MgAADnNtb292AAAAbG12aGQAAAAA5h/8J+Yf/CcAAKxEAAKxEAABAAABAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAIlHRy"fileNamestring必填文件名
文件名，需含扩展名。
字段示例："123123.MP4"thumbBase64string必填视频封面图的 base64（不含 data: 前缀）。注意是图片，不是地址。
"/9j/4AAQSkZJRgABAQAASABIAAD/4QBARXhpZgAATU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAAqACAAQAAAABAAAC0KADAAQAAAABAAAFAAAAAAD/7QA4UGhvdG9zaG9wIDMuMAA4QklNBAQAAAAAAAA4QklNBCUAAAAAABDUHYzZjwCyBOmACZjs+EJ+/+ICpElD"widthint64必填视频宽
视频宽度（像素）。必填。
字段示例：1920heightint64必填视频高
视频高度（像素）。必填。
字段示例：1080响应与结果确认
本接口为能力层原样返回，不统一增加青鸾外层信封。code = 0 仅表示请求被接受，不保证副作用已完成。
请结合业务数据与本页说明判断实际状态，不要仅凭响应码推断操作效果。
响应字段与 HTTP 状态
HTTP 200
能力层原样返回；code = 0 仅表示请求已受理，业务结果须按接口说明确认。
application/json
查看响应字段定义
接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断：HTTP 200 只表示请求已送达，成功以 code = 0 为准。
codeinteger必填业务状态码
业务状态码：0 表示成功，-1 表示失败；失败原因见 message。
0dataobject可选业务数据
媒体上传结果。当前版本字段与历史版本字段可能并存，请优先以实际响应为准并按字段名原样传递。
idstring可选对象 ID。发消息返回时即 serverMsgId（撤回要用）；上传返回时即 fileId（发送/下载要用）；列表项中为该条记录 ID
sizeint64可选文件字节数。由上传接口返回
最小值：0durationint64可选视频或语音时长，单位以接口说明为准。
注意：服务端解析视频得到，入参没有该字段。本次返回 93，单位未确认（源视频时长未留存，无法确认是秒还是其它单位）。
0widthint64可选图片/视频宽度（像素）
最小值：0heightint64可选图片/视频高度（像素）
最小值：0thumbUrlstring可选封面或缩略图地址。
注意：服务端生成的缩略图直链（64 字符）。sendVideo 需原样带上。
md5string可选MD5 校验值
文件 MD5。由上传接口返回，可用于校验
fileIdstring可选文件资源 ID
旧版响应中的媒体文件 ID。
aesKeystring可选媒体解密密钥
旧版响应中的媒体解密密钥。
fileKeystring可选旧版响应中的上传任务键。
fileNamestring可选文件名
旧版响应中的文件名。
fileMd5string可选旧版响应中的文件 MD5。
fileSizeint64可选文件大小
旧版响应中的文件大小，单位为字节。
最小值：0thumbMd5string可选缩略图 MD5。
thumbSizeint64可选缩略图大小，单位为字节。
最小值：0thumbWidthint64可选缩略图宽度，单位为像素。
最小值：0thumbHeightint64可选缩略图高度，单位为像素。
最小值：0detailstring可选错误详情
错误详情；无补充信息时通常为空字符串。
messagestring必填响应消息
业务结果消息。成功通常为 ok；企微错误通常为 错误码|错误信息。
"ok"timestring必填服务端时间
服务端时间，格式为 YYYY-MM-DD HH:mm:ss。
"2026-07-21 07:33:17"HTTP 403
受控接口，需通过控制台配置
HTTP 404
appid 不存在或无权访问