跳转到主要内容

PDF 转图片 API

上传一个 PDF,按页返回渲染后的图片。每页消耗 1 积分。

接口

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_ERROR
INVALID_PROVIDER_RESPONSE
PDF 服务内部错误,请稍后重试。
503 PROVIDER_UNAVAILABLE PDF 服务暂时不可用,请稍后重试。