上传与下载

上传聊天资源、获取文件或群头像。上传返回的 media 可以直接用于发送消息。

每个接口独立列出请求参数、返回字段和示例。点击下方接口名称即可查看。

接口列表

接口	方法	路径
上传聊天资源	POST	/app/sdk/media/upload
上传视频及封面	POST	/app/sdk/media/video
读取文件	GET	/app/file/{year}/{month}/{key}/{file_name}
读取群组合头像	GET	/uploads/avatars/group/{group_id}/{file}
读取文件响应头	HEAD	/app/file/{year}/{month}/{key}/{file_name}
读取群头像响应头	HEAD	/uploads/avatars/group/{group_id}/{file}

上传资源

先上传，再用返回的完整 media 发送消息。上传本身不会往聊天里发出消息。

• 上传聊天资源
• 发送消息

视频与封面一起上传

竖屏视频可配一张清晰封面，一起上传后发送。

• 上传视频及封面

支持范围与尺寸

图片、语音、视频和文件有不同格式要求。默认限制可在后台调整，客户端以首页返回的 media_limits 为准。

• 上传聊天资源
• 读取首页数据

文件下载

使用上传结果或消息中的完整 URL，支持读取文件和只检查响应头。

• 读取文件
• 读取文件响应头

群组合头像

直接使用 Group.avatar。服务器通过 ETag 支持缓存，不需要自己计算图片版本。

• 读取群组合头像
• 读取群头像响应头

SDK 中的展示

SDK 已处理媒体预览、语音和名片展示，宿主从 SDK 接入指南开始即可。