跳转到主要内容
TransConvert

PDF Compression API

Shrink PDF files with one POST request via Ghostscript's own recompression — pick a quality level, optionally convert to grayscale, and never get back a file bigger than what you uploaded.

POST https://transconvert.com/api/v1/convert.php

参数

Field Description
AuthorizationRequired. "Bearer tc_live_...".
categorySet to "document-compress".
levelOptional: "low", "medium" (default), "high", or "none".
grayscaleOptional. "1" to also convert to grayscale; omit for full color.
fileRequired. A PDF that is not open/password-protected.

示例

TransConvert
curl -X POST \
  https://transconvert.com/api/v1/convert.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=document-compress" \
  -F "level=high" \
  -F "file=@report.pdf" \
  -o output.pdf

响应

成功时(200):返回转换后文件的原始字节,并设置相应的 Content-Type 和 Content-Disposition 响应头。失败时:返回如 {"error": {"code": "...", "message": "..."}} 结构的 JSON,并附带相应的 HTTP 状态码——请参见下方的错误说明。

Header Value
Content-Type转换后文件的实际 MIME 类型(例如 image/png、application/pdf)。
Content-Dispositionattachment; filename="..."——建议的文件名,与普通文件下载相同。
Content-Length响应体的大小(字节)。
X-Original-Size上传文件在压缩前的大小(字节)。
X-Saved-Percent结果文件相对于原文件缩小的大致比例,以整数百分比表示(可以为 0)。

所有错误都遵循相同的 JSON 结构,例如超出额度时:

429 Too Many Requests
{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly API allowance of 5000 conversion-minutes reached.",
    "limit": 5000,
    "used": 5000
  }
}

错误

每个失败请求都会返回一个 JSON 错误信息,其中包含可供代码判断分支的 "code",以及便于阅读的 "message"。部分错误还包含额外字段(例如 quota_exceeded 会包含 "limit" 和 "used")。

Status & code When it happens
401 missing_key未发送 Authorization 请求头。
401 invalid_key密钥不存在,或已被撤销。
403 account_suspended拥有此密钥的账户已被暂停。
403 plan_required该账户为 Free 套餐——API 访问权限需要 Basic、Lite、Pro 或 Team 套餐。
400 invalid_category"category" 既不是 "image" 也不是 "document"。
400 no_file未发送文件,或上传失败——字段名必须为 "file"。
413 file_too_large文件大小超出您所在套餐的最大上传限制。
429 quota_exceeded该套餐每月的转换分钟数已用完,将于下个自然月初重置。
429 concurrency_limit此账户同时运行的转换任务过多(与网站共用限额)——请等待其中一个完成后重试。
422 conversion_failed文件本身无法转换——"message" 中会说明原因。状态码会因原因而异:400/415/422 表示无论重试多少次,该文件或目标格式都无法成功;500/503 表示服务器端出现问题,其中 503 值得进行一次短暂重试。

Supported formats

PDF

相关内容