DocForge

DOCX, XLSX, PPTX and HTML to PDF, PDF merge, and HTML-template-to-image rendering in one REST API. One unit per call whatever the file size or page count — failed calls are never billed.

原始信息汇总

DocForge API 数据集详情

基本信息

• API名称: DocForge
• 类别: 商业软件（Business Software）
• API创建者: Aatr Sin
• 订阅用户数: 2
• 当前版本: 1.1.0
• 所属平台: RapidAPI

API概述

DocForge 是一个文档处理 REST API，支持将 DOCX、XLSX、PPTX 和 HTML 转换为 PDF，支持 PDF 合并，以及将 HTML 模板渲染为图片。每次调用仅计费一个单位，无论文件大小或页数如何，失败的调用从不计费。

核心功能

• 将 DOCX、XLSX、PPTX、ODT、RTF、CSV 和 TXT 转换为 PDF。
• HTML 转 PDF。
• 多个 PDF 合并为一个。
• 将 HTML 模板及 JSON 数据渲染为 PNG、JPEG 或 WebP 图片，适用于 Open Graph 卡片、证书、横幅和收据等场景。

端点详情

端点	功能	返回格式
POST /v1/convert/office	Office 文档转 PDF	application/pdf
POST /v1/convert/html	HTML 转 PDF	application/pdf
POST /v1/pdf/merge	合并多个 PDF	application/pdf
POST /v1/image/render	HTML 模板转图片	image/png、image/jpeg、image/webp
GET /v1/usage	查看本月用量	application/json

主要参数与限制

• Office 转换：支持 .doc、.docx、.odt、.rtf、.txt、.xls、.xlsx、.ods、.csv、.ppt、.pptx、.odp 格式，可设置横向/纵向模式。
• HTML 转换：需提供完整的 HTML 文档，可获取外部 CSS、图片和 Web 字体，支持设置页面边距。
• PDF 合并：需提供两个或以上 PDF 文件，按发送顺序合并。
• 图片渲染：HTML 模板支持 Jinja2 占位符（最大 256 KB），可自定义数据、图片宽高（默认 1200×630 像素）及输出格式（png/jpeg/webp）。
• 请求体限制：每次请求总大小最大 32 MB（合并时指所有文件的合并大小）。
• 模板大小限制：256 KB。
• 超时时间：180 秒。
• 典型延迟：HTML 转 PDF 约 1.8 秒，DOCX 转 PDF 约 3.4 秒，1200×630 PNG 渲染约 3.3 秒。

计费方式

每次成功调用计费一个单位，文件大小和页数不影响费用，请求出错不计入配额。

错误处理

状态码	含义
400	请求格式错误——缺少必填字段或值无效
413	请求体超过 32 MB，或模板超过 256 KB
415	该端点不支持的文件类型
422	请求体无法解析
429	达到速率限制或月度配额
504	渲染超时——通常由模板加载外部资源过慢引起

所有错误均返回包含 detail 字段的 JSON 格式响应，说明需要修改的内容。

使用方式

无需调用 SDK，所有转换端点直接返回文件本身作为响应体，无需轮询、无需任务 ID、无需事后获取签名 URL，可通过简单的 HTTP 请求直接调用。