格式转换

将图片导出为递交系统接受的光栅格式:拼合 TIFF、PDF 或高分辨率 PNG。矢量输出(SVG / DXF)请用矢量化。

POST https://patentfig.ai/api/v1/convert

每次调用消耗 20 积分。

参数

图片输入遵循共用约定(JSON imageUrl 或 multipart file)。

字段	类型	必填	默认	说明
`imageUrl` / `file`	string / file	是	—	待转换的图片。
`format`	`"png"` \| `"tiff"` \| `"pdf"`	否	`"png"`	输出格式。TIFF 为 LZW 压缩的拼合图。
`dpi`	`300` \| `600`	否	`300`	目标预设:300 DPI 对应约 2K 分辨率,600 DPI 对应约 4K。小图会先 AI 放大到目标分辨率。

请求

curl -X POST https://patentfig.ai/api/v1/convert \
  -H "Authorization: Bearer pfig_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://example.com/figure.png",
    "format": "tiff",
    "dpi": 600
  }'

响应

{
  "success": true,
  "data": {
    "url": "https://cdn.patentfig.ai/api/…/….tiff",
    "previewUrl": "https://cdn.patentfig.ai/api/…/….png",
    "format": "tiff",
    "dpi": 600,
    "creditsConsumed": 20
  }
}

TIFF 和 PDF 输出会附带 previewUrl(PNG 预览)。

错误

常见:INVALID_INPUT(400)、FETCH_FAILED(422)、INSUFFICIENT_CREDITS(402)、GENERATION_FAILED(500)。详见错误参考。