接口
POST
https://api.404wl.com/v1/pdf2img
请求参数
| 字段 | 类型 | 说明 |
|---|---|---|
file |
file |
必填。PDF 文件,最大 10 MiB。 |
format |
string |
输出格式:png(默认)、jpeg 或 webp。 |
dpi |
integer |
渲染分辨率,1–300,默认 150。 |
quality |
integer |
1–100,默认 90,仅 jpeg 和 webp 生效。 |
pages |
string |
要转换的页,形如 1-3,5,8-10,页码从 1 开始,重复页会去重。不传则转换整个文档。 |
调用示例
cURL
curl --request POST 'https://api.404wl.com/v1/pdf2img' \
--header 'Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--form 'file=@./example.pdf' \
--form 'format=jpeg' \
--form 'pages=1-3'
JavaScript
const form = new FormData();
form.append('file', file);
form.append('format', 'jpeg');
form.append('pages', '1-3');
const response = await fetch('https://api.404wl.com/v1/pdf2img', {
method: 'POST',
headers: {
Authorization: `Bearer ${apiKey}`,
},
body: form,
});
const result = await response.json();
响应格式
page_count 是文档总页数,converted_pages 是本次实际转换的页数,两者都返回以便核对用量。page 是文件内的原始页码,每页图片以 base64 内嵌。
{
"success": true,
"request_id": "provider-request-id",
"data": {
"page_count": 12,
"converted_pages": 3,
"format": "jpeg",
"dpi": 150,
"pages": [
{
"page": 1,
"width": 1240,
"height": 1755,
"image_base64": "..."
}
]
},
"error": null
}
错误码
通用错误见 错误格式。本接口还可能返回:
| HTTP | code | 说明 |
|---|---|---|
400 |
EMPTY_FILE |
上传的文件为空。 |
402 |
PAGE_SELECTION_REQUIRED |
可用积分不足以按整份文档预扣,请用 pages 指定本次要转换的页。 |
413 |
FILE_TOO_LARGE |
PDF 超过上传大小限制。 |
413 |
TOO_MANY_PAGES |
选中的页数超过单次上限。 |
413 |
OUTPUT_TOO_LARGE |
输出的图片总量超过单次上限,可降低 dpi 或减少页数。 |
413 |
PAGE_TOO_LARGE |
单页渲染后的尺寸超过上限,可降低 dpi。 |
415 |
UNSUPPORTED_FILE |
不是可读取的 PDF。 |
422 |
INVALID_REQUEST |
缺少文件或请求参数无效。 |
422 |
PAGE_OUT_OF_RANGE |
pages 超出文档页数。 |
422 |
PASSWORD_REQUIRED |
PDF 已加密,需要先解除密码保护。 |
422 |
UNSUPPORTED_ENCRYPTION |
PDF 使用了不支持的加密方式。 |
502 |
PROVIDER_ERRORINVALID_PROVIDER_RESPONSE |
PDF 服务内部错误,请稍后重试。 |
503 |
PROVIDER_UNAVAILABLE |
PDF 服务暂时不可用,请稍后重试。 |