公眾號在使用接口時，對多媒體文件、多媒體消息的獲取和調(diào)用等操作，是通過media_id來進行的。通過本接口，公眾號可以上傳或下載多媒體文件。但請注意，每個多媒體文件（media_id）會在上傳、用戶發(fā)送到微信服務(wù)器3天后自動刪除，以節(jié)省服務(wù)器資源。

上傳多媒體文件

公眾號可調(diào)用本接口來上傳圖片、語音、視頻等文件到微信服務(wù)器，上傳后服務(wù)器會返回對應(yīng)的media_id，公眾號此后可根據(jù)該media_id來獲取多媒體。請注意，media_id是可復(fù)用的，調(diào)用該接口需http協(xié)議。

接口調(diào)用請求說明

http請求方式: POST/FORM

http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

調(diào)用示例（使用curl命令，用FORM表單方式上傳一個多媒體文件）：

curl -F media=@test.jpg "http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

參數(shù)說明

返回說明

正確情況下的返回JSON數(shù)據(jù)包結(jié)果如下：

{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}

錯誤情況下的返回JSON數(shù)據(jù)包示例如下（示例為無效媒體類型錯誤）：

{"errcode":40004,"errmsg":"invalid media type"}

注意事項

上傳的多媒體文件有格式和大小限制，如下：

圖片（image）: 1M，支持JPG格式

語音（voice）：2M，播放長度不超過60s，支持AMR\MP3格式

視頻（video）：10MB，支持MP4格式

縮略圖（thumb）：64KB，支持JPG格式

媒體文件在后臺保存時間為3天，即3天后media_id失效。

使用網(wǎng)頁調(diào)試工具調(diào)試該接口

下載多媒體文件

公眾號可調(diào)用本接口來獲取多媒體文件。請注意，視頻文件不支持下載，調(diào)用該接口需http協(xié)議。

接口調(diào)用請求說明

http請求方式: GET

http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

請求示例（示例為通過curl命令獲取多媒體文件）

curl -I -G "http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

參數(shù)說明

返回說明

正確情況下的返回HTTP頭如下：

HTTP/1.1 200 OK 
Connection: close 
Content-Type: image/jpeg 
Content-disposition: attachment; filename="MEDIA_ID.jpg" 
Date: Sun, 06 Jan 2013 10:20:18 GMT 
Cache-Control: no-cache, must-revalidate 
Content-Length: 339721 
curl -G "http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_I 

錯誤情況下的返回JSON數(shù)據(jù)包示例如下（示例為無效媒體ID錯誤）：:

{"errcode":40007,"errmsg":"invalid media_id"}

使用網(wǎng)頁調(diào)試工具調(diào)試該接口