上传图片
... 2026-2-4 小于 1 分钟
# 上传图片
# 接口说明
本接口可以将图片资源上传至腾讯文档。
- 单张图片最大20M
- 支持的格式(png/gif/jpeg/bmp/webp/jpg/svg)
# 请求格式
| 描述 | 定义 |
|---|---|
| Path | /api/v6/openapi/drive/v3/image:upload |
| Method | POST |
| Content-Type | multipart/form-data; boundary={calculated when request is sent}; charset=utf-8 |
# 请求头部
详见Headers。
# 请求参数
# 请求体
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| image | HTTP FORM File | 是 | 需要上传的源文件 |
# 请求示例
curl --location 'https://{domain}/api/v6/openapi/drive/v3/image:upload' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--form 'image=@"/Users/xxx/Downloads/test.png"'
1
2
3
4
2
3
4
1
2
3
4
2
3
4
# 响应参数
# 响应体
| 参数名 | 类型 | 描述 |
|---|---|---|
| imageId | string | 用户上传图片获取到imageID 用于插入到文档 |
# 响应示例
{
"imageId": "8dLBFf/MdJkW8SkWENh/yRzm4UbzkwywEExPlRe30YcocXBqXT0v1hgTfge35GBp8mibeL+ANvc9rtTyIzTidk4QpQ=="
}
1
2
3
2
3
1
2
3
2
3