Frequently used assets may be uploaded via this API to the Weixin server permanently. New permanent assets can be managed in Media Asset Management module on Official Accounts Platform.

Notes:

1. Last update: Once added, new permanent images are returned with URLs for developers to use on all Tencent domain names (images will be hidden if used on external domain names).

2. An Official Account's media asset library is subject to a maximum storage limit: 5,000 for articles and images and 1,000 for other types of assets.

3. The format and size restrictions for assets are the same as shown on the Official Accounts Platform:

Image: 10 MB. BMP, PNG, JPEG, JPG, and GIF formats are supported.

Voice: 2 MB. The maximum length is 60s. MP3, WMA, WAV, and AMR formats are supported.

Video: 10 MB. The MP4 format supported.

Thumbnail: 64 KB. The JPG format supported.

4. The Weixin backend will filter out any external image links in articles. Image URLs must be obtained by uploading images via the "Upload Image in Article to Obtain URL" API.

5. Images uploaded via the "Upload Image in Article to Obtain URL" API are excluded from the maximum storage limit of 5,000 images for an Official Account's media asset library. Only JPG/PGN images smaller than 1 MB are supported.

6. Links to articles broadcasted from your account and other Official Accounts can be added in the main body of the article.

# Adding New Permanent Articles

API Request Format

HTTP request method: POST. HTTPS protocol is used.
https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN

Calling Example

{
    "articles": [{
     "title": TITLE,
    "thumb_media_id": THUMB_MEDIA_ID,
    "author": AUTHOR,
    "digest": DIGEST,
    "show_cover_pic": SHOW_COVER_PIC(0 / 1),
    "content": CONTENT,
    "content_source_url": CONTENT_SOURCE_URL,
    "need_open_comment":1,
    "only_fans_can_comment":1
},
    //If multiple articles are added, there should also be more segments of structure information here for these articles.
]
}

Parameters

Response Description

{
   "media_id":MEDIA_ID
}

The media_ID of the added article asset is returned.

# Uploading Image in Article to Obtain URL

Images uploaded via this API are excluded from the maximum storage limit of 5,000 images for an Official Account's media asset library. Only JPG/PGN images smaller than 1 MB are supported.

API Request Format

HTTP request method: POST. HTTPS protocol is used.
https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
Calling Example (using the curl command to upload an image via FORM):
curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"

Parameters

Response Description The result returned for a successful request:

{
    "url":  "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"

}

The above URL is the URL of the uploaded image and can be used in articles.

# Adding Other Types of Permanent Assets

API Request Format

This API is called via a POST form. The form ID is "media" and includes the asset content to be uploaded, as well as information such as filename, filelength, and content-type. Note: Images will be put into the default group of Media Asset Management module on Official Accounts Platform.

HTTP request method: POST. HTTPS protocol is used.
https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE
Calling Example (using the curl command to add another type of permanent asset via FORM. See more information for the use of curl.)

Parameters

Note the following when adding permanent videos:

Another form is required via POST to upload videos. The ID is "description" and includes a description of the asset. The content is in JSON format as below:

{
    "title":VIDEO_TITLE,
    "introduction":INTRODUCTION
}

Calling example for adding permanent videos:

curl "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE" -F media=@media.file -F  description='{"title":VIDEO_TITLE, "introduction":INTRODUCTION}'

Parameters

Response Description

{
  "media_id":MEDIA_ID,
  "url":URL
}

Response Parameters

The returned JSON packet for a failed request (this is an example of invalid media type):

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