HTML & PDF to ZPL Converter

Convert HTML or PDF into ZPL for Zebra thermal printers. Z64-compressed output is 50–100× smaller than ASCII hex — labels that print in seconds, not minutes.

原始信息汇总

API 概述

该 API 的核心功能是将 PDF 和 HTML 标签转换为适用于斑马（Zebra）热敏打印机的 ZPL 格式，并默认采用 Z64 压缩，显著减小数据传输量。其典型效果为：ASCII 十六进制编码约需 248 KB，而 Z64 压缩后仅约 2.5 KB，体积缩小 50–100 倍，从而加快打印速度、降低网络带宽占用并减少打印机通信开销。

核心特性

• Z64 压缩：默认启用，支持 CRC-16/CCITT-FALSE 算法，且 CRC 校验值已根据标准发布值验证。
• 图像极性处理：明确处理位图极性，避免因极性反转导致标签打印为负片效果（如整页变黑）。
• 阈值处理：默认采用阈值模式，适用于包含文本、条码、QR 码、徽标等的标签；同时提供可选的抖动模式，用于照片等需要灰度表现的场景。
• 无头浏览器渲染：HTML 直接渲染，无需启动 Chrome 等无头浏览器，从而加快启动速度、降低内存占用，转换延迟更可预测。支持的 HTML 特性包括文本、图像、表格及内联样式，但不支持 Flexbox 和 CSS Grid。
• 打印预览：支持将 ZPL 图形字段（如 ^GFA）转换回 PNG 进行预览，流程为“转换 → 预览 → 验证 → 打印”。预览接口仅处理图形字段，对不支持的 ZPL 命令返回 422 错误，而非静默生成错误结果。
• 打印机配置明确：支持 203、300、600 DPI（对应 8、12、24 点/毫米），输出中包含显式的 ^PW（打印宽度）和 ^LL（标签长度），不依赖打印机前一任务的残留设置。

端点列表

方法	端点	描述
POST	/v1/pdf-to-zpl	将 PDF 页面转换为 ZPL，每页生成一个标签
POST	/v1/html-to-zpl	将 HTML 标签转换为 ZPL
POST	/v1/zpl-to-png	将支持的 ZPL 图形字段预览为 PNG
GET	/v1/printers	支持的密度和标签尺寸
GET	/health	限制、能力及支持的编码方式

应用场景

适用于运输标签、仓库标签、产品标签、库存标签、条码标签、物流单据、电商履约、自动化打印系统、ERP/WMS 集成以及斑马打印机工作流等场景。

隐私与范围说明

• 隐私设计：文档仅在内存中处理并随即丢弃，不会被保留。API 仅用于格式转换，不会构建运输文档数据库。
• 范围诚实性：该 API 并非完整的斑马浏览器或 ZPL 解释器，而是专注于将常见的 PDF 和 HTML 标签布局高效、可预测地转换为紧凑且可直接打印的 ZPL。对于超出支持范围的输入，API 会返回明确错误，而非生成看似有效实则打印错误的标签。

订阅方案

提供 BASIC（$0.00/月）、PRO（$19.00/月）、ULTRA（$49.00/月）和 MEGA（$149.00/月）四种订阅计划。