上传附件资源

POST

/cgi-bin/media/upload_attachment

素材上传得到media_id，该media_id仅三天内有效
media_id在同一企业内应用之间可以共享

使用multipart/form-data POST上传文件，文件标识名为”media”

POST的请求包中，form-data中媒体文件标识，应包含有 filename、filelength、content-type等信息

filename标识文件展示的名称。比如，使用该media_id发消息时，展示的文件名由该字段控制

上传的媒体文件限制

所有文件size必须大于5个字节

图片（image）：2MB，支持JPG,PNG格式

语音（voice）：2MB，播放长度不超过60s，仅支持AMR格式

视频（video）：10MB，支持MP4格式

普通文件（file）：20MB

请求参数

Query 参数

Body 参数multipart/form-data

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/media/upload_attachment?access_token={{ACCESS_TOKEN}}&media_type={{TYPE}}&attachment_type=1' \
--form 'media=@""'

响应示例

{
   "errcode": 0,
   "errmsg": ""，
   "type": "image",
   "media_id": "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
   "created_at": 1380000000
}

修改于 2025-09-18 10:22:06

管理聊天敏感词删除敏感词规则

概述

上传附件资源

上传的媒体文件限制#

请求参数

返回响应

上传的媒体文件限制