PatentFig AI 文档矢量化
POST /v1/vectorize — 光栅图转 SVG、DXF 或矢量 PDF
将光栅图片转换为可编辑的矢量文件。
POST https://patentfig.ai/api/v1/vectorize每次调用消耗 20 积分。
图片输入
所有接收图片的接口共用两种形式:
- JSON body 带
imageUrl字段——公网可访问的 URL;或 multipart/form-data带file字段。
支持 PNG、JPEG、WebP、TIFF,最大 10 MB。
参数
| 字段 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
imageUrl / file | string / file | 是 | — | 待矢量化的图片。 |
format | "svg" | "dxf" | "pdf" | 否 | "svg" | 输出格式。PDF 内嵌 SVG 便于后续提取。 |
engine | "lineart" | "trace" | 否 | "lineart" | 见下文。 |
引擎选择
lineart(线稿重绘) —— AI 将图像重绘为干净的单线条专利线稿,每条线是一条路径,这正是 DXF 能在 CAD 中可用的原因。专利附图首选。trace(精确描摹) —— 逐像素忠实描摹,保留填充和阴影,适合要求输出与原图一致的场景。注意:描摹输出为填充轮廓,DXF 中可能出现双线,CAD 用途请选lineart。
请求
curl -X POST https://patentfig.ai/api/v1/vectorize \
-H "Authorization: Bearer pfig_xxx" \
-H "Content-Type: application/json" \
-d '{
"imageUrl": "https://example.com/drawing.png",
"format": "dxf",
"engine": "lineart"
}'响应
{
"success": true,
"data": {
"url": "https://cdn.patentfig.ai/api/…/….dxf",
"format": "dxf",
"engine": "lineart",
"creditsConsumed": 20
}
}错误
常见:INVALID_INPUT(400)、FETCH_FAILED(422,imageUrl 无法访问)、INSUFFICIENT_CREDITS(402)、GENERATION_FAILED(500)。详见错误参考。