请求地址
POST https://api.qingluanbot.com/qingluan/api/cdn/uploadVideo
请求示例
curl -X POST 'https://api.qingluanbot.com/qingluan/api/cdn/uploadVideo' \
-H 'X-Qingluan-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"ql_appid": "inst_xxxxxxxxxxxx",
"base64": "AAAAHGZ0eXBtcDQyAAAAAWlzb21tcDQxbXA0MgAADnNtb292AAAAbG12aGQAAAAA5h/8J+Yf/CcAAKxEAAKxEAABAAABAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAIlHRy",
"fileName": "123123.MP4",
"thumbBase64": "/9j/4AAQSkZJRgABAQAASABIAAD/4QBARXhpZgAATU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAAqACAAQAAAABAAAC0KADAAQAAAABAAAFAAAAAAD/7QA4UGhvdG9zaG9wIDMuMAA4QklNBAQAAAAAAAA4QklNBCUAAAAAABDUHYzZjwCyBOmACZjs+EJ+/+ICpElD",
"width": 1920,
"height": 1080
}'
请求参数
| 字段 | 类型 | 要求 | 说明 |
|---|
ql_appid | string | 必填 | 青鸾实例 ID，形如 inst_xxxx。在开发者控制台「实例与回调」扫码上号后获得。 |
base64 | string | 必填 | 视频内容的 base64（不含 data: 前缀）。必须是结构完整的 mp4 —— 缺 moov 元数据盒的文件会被拒绝。 |
fileName | string | 必填 | 文件名，需含扩展名。 |
thumbBase64 | string | 必填 | 视频封面图的 base64（不含 data: 前缀）。注意是图片，不是地址。 |
width | integer | 必填 | 视频宽度（像素）。必填。 |
height | integer | 必填 | 视频高度（像素）。必填。 |
响应判断
能力层接口返回包含 code、message、time 与 data 等字段；请以 code=0 判断业务成功。HTTP 200 只表示网关已返回响应，不能替代业务状态判断。
可能的响应状态
| HTTP 状态 | 公开契约说明 |
|---|
200 | 原样返回（code = 0 即成功） |
403 | 受控接口，需通过控制台配置 |
404 | ql_appid 不存在或无权访问 |
200 响应示例
{
"code": 0,
"data": {
"id": "REPLACE_WITH_ID",
"size": 0,
"duration": 0,
"width": 0,
"height": 0,
"thumbUrl": "https://your.app/qingluan/callback",
"md5": "请按接口说明填写"
},
"detail": "请按接口说明填写",
"message": "ok",
"time": "2026-07-21 07:33:17"
}
接入步骤
- 在青鸾开发者控制台创建或查看 API Key。
- 在「实例与回调」接入企业微信账号，取得
ql_appid。 - 请求头携带
X-Qingluan-Key，按当前契约提交 JSON 请求。 - 读取响应中的
code；仅当 code=0 时按成功流程处理。