全部文档
当前文档
最近更新时间：2026-03-31 14:10:27
doc/convert
通过文档格式转换功能，您可以将PDF文档转换为PNG、JPG、JPEG目标格式，支持指定转换页面范围，并可将转换结果保存至指定KS3路径。
该接口操作需要源文档Object的读权限，对转存目标Bucket具有写权限
必须结合文档处理持久化使用，使用文档处理持久化功能前必须先通过KS3控制台完成服务授权与开通，操作路径为：进入需要启用文档处理的存储桶->【数据处理】->【文档处理】
不支持匿名访问
POST /{ObjectKey}?x-kss-process HTTP/1.1
Host: {BucketName}.{endpoint}
Content-Length: {Content-Length}
Date: {date}
x-kss-storage-class: {StorageClass}
Authorization: {SignatureValue}
x-kss-process=doc/convert,source_pdf,target_png,pages_MSwyLDMtNQ|sys/saveas,o_,b_(转存操作)参数名称 | 参数含义 | 是否必填 | 取值范围 |
source | 文档源文件格式 | 否 | |
target | 目标图片格式 | 是 | • png • jpg • jpeg |
pages | 页码 | 否 | 转换文档页码，需经过URL Safe的Base64编码，请参见编码步骤。不填时转换PDF全部页，单页用“,”隔开，页数范围用“-”隔开，支持单页和页数范围组合使用。部分页码范围超出文档最大页码时，超出部分不输出；全部页码超出文档最大页码时，输出文档全部页。 单页：1,2,10 范围：1-10,20-30 |
需使用sys/saveas参数将转换后的图片保存在指定的Bucket中，请参见文档处理持久化。
该请求不需要设置特殊的头部。
如果请求处理成功，则返回如下JSON格式的转存成功的内容:
HTTP/1.1 200 OK
Server: KS3
Date: {date}
Connection: keep-alive
Content-Length:{Content-Length}
Content-Type:{content-type}
x-kss-request-id:f0uv****2gj4
{
"bucket": "bucket_name",
"succeededItems": ["object_key_1","object_key_2","object_key_3"],
"errors": [],
"totalCount": "count_number"
}如果请求失败，则返回如下JSON格式的内容：
{
"requestId": <requestId String>,
"errorCode": <ErrorCode Integer>,
"code": <code String>,
"message": <ErrorMessage String>
}HTTP状态码 | 描述 |
400 |
|
403 | 签名不匹配或无操作对应权限 |
404 | 请求的资源不存在 |
500 | 服务器端操作失败。如果遇到此种错误，请及时联系我们 |
// 将文档suiyi.pdf的1-10页转换为PNG格式的图片文件
POST /suiyi.pdf?x-kss-process HTTP/1.1
Host: ks3-resources.ks3-cn-beijing.ksyuncs.com
Content-Length: {Content-Length}
Date: {date}
Authorization: {SignatureValue}
x-kss-process=doc/convert,source_pdf,target_png,pages_MS0xMA|sys/saveas,o_ZG9jX2ltYWdlcy97a2V5fS17aW5kZXh9LnthdXRvZXh0fQ,b_e2J1Y2tldH0纯净模式