上传视频到 CDN

上传小视频（base64）+ 封面图，拿到 message/sendVideo 所需凭证。

说明与注意

• 返回新字段名 id/aesKey/md5/size + duration/width/height/thumbUrl（封面为单个 thumbUrl 直链，无 thumbMd5/thumbSize/thumb宽高 分列）；size/duration/宽高 与源视频一致。一次上传同时落地视频（download fileType=4）与封面（fileType=3）两变体，md5 各自一致。小视频 base64 直传；大视频走 uploadBigFile。

请求参数

参数	必填	类型	说明
appid	是	string	实例 appid，标识操作哪个已登录账号。示例：we_xxxxxxxxxxxxxxx
base64	是	string	文件 base64，不含 data: 前缀；单次请求体最大 8MB，超过时用上传大文件到 CDN。示例：<视频 base64>
fileName	是	string	文件名。示例：123123.MP4
thumbBase64	是	string	封面图 base64。示例：<封面 jpg base64>

请求示例

HTTP

POST {BASE_URL}/wx-api/api/cdn/uploadVideo
Authorization: Bearer <你的 App Token>
Content-Type: application/json

{
  "appid": "we_xxxxxxxxxxxxxxx",
  "base64": "<视频 base64>",
  "fileName": "123123.MP4",
  "thumbBase64": "<封面 jpg base64>"
}

curl

curl -X POST '{BASE_URL}/wx-api/api/cdn/uploadVideo' \
  -H 'Authorization: Bearer <你的 App Token>' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "appid": "we_xxxxxxxxxxxxxxx",
  "base64": "<视频 base64>",
  "fileName": "123123.MP4",
  "thumbBase64": "<封面 jpg base64>"
}'

Python

import requests

url = "{BASE_URL}/wx-api/api/cdn/uploadVideo"
headers = {"Authorization": "Bearer <你的 App Token>", "Content-Type": "application/json"}
body = """{
  "appid": "we_xxxxxxxxxxxxxxx",
  "base64": "<视频 base64>",
  "fileName": "123123.MP4",
  "thumbBase64": "<封面 jpg base64>"
}"""

resp = requests.post(url, headers=headers, data=body.encode("utf-8"))
print(resp.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String url = "{BASE_URL}/wx-api/api/cdn/uploadVideo";
String body = "{\n" +
    "  \"appid\": \"we_xxxxxxxxxxxxxxx\",\n" +
    "  \"base64\": \"<视频 base64>\",\n" +
    "  \"fileName\": \"123123.MP4\",\n" +
    "  \"thumbBase64\": \"<封面 jpg base64>\"\n" +
    "}";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
    .header("Authorization", "Bearer <你的 App Token>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

PHP

<?php

$url = '{BASE_URL}/wx-api/api/cdn/uploadVideo';
$body = <<<'JSON'
{
  "appid": "we_xxxxxxxxxxxxxxx",
  "base64": "<视频 base64>",
  "fileName": "123123.MP4",
  "thumbBase64": "<封面 jpg base64>"
}
JSON;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <你的 App Token>',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

响应示例

{
  "code": 0,
  "data": {
    "id": "3068…0400",
    "size": 2044,
    "duration": 1,
    "width": 320,
    "height": 240,
    "thumbUrl": "https://wework.qpic.cn/wwpic3az/…/0",
    "aesKey": "127388d4…",
    "md5": "38cbde78…"
  },
  "detail": "",
  "message": "ok",
  "time": "2026-09-11 20:10:00"
}

响应字段

响应字段（13 项）

字段	类型	说明
code	int64	统一封套状态码：0=成功，负数=失败
data	object	视频凭证，含 id 与单个 thumbUrl 等字段，可原样传给发送视频消息的 content
data.id	string	记录/文件业务标识
data.size	int64	文件字节数
data.duration	int64	时长（秒）
data.width	int64	宽（像素）
data.height	int64	高（像素）
data.thumbUrl	string	封面图 url
data.aesKey	string	AES 下载解密密钥；CDN 存的是加密字节，下载后用它解密
data.md5	string	文件内容 MD5，收发方一致性校验
detail	string	附加明细，通常为空
message	string	文案：成功为 ok；失败形如 -码|描述
time	string	服务端处理时间 YYYY-MM-DD HH:MM:SS

下一步

• CDN 文件模块总览
• 错误码
• 快速开始