用途：通过 PatentFig AI REST API 生成与转换专利附图。基础地址 https://patentfig.ai/api/v1，鉴权用 Authorization: Bearer $PATENTFIG_API_KEY，所有端点同步返回 JSON（成功 { "success": true, "data": {...} }，失败 { "success": false, "error": { "code", "message" } }），生成文件以 https://cdn.patentfig.ai 上的 URL 返回。
主要能力：POST /figures 由一段提示词生成一张图，视图、图类型与构图均由提示词控制，多视图需逐视图调用；output 可选 png（默认）或 svg（描边线稿，适合 CAD），labeled: true 添加专利式数字标号，referenceImageUrls 最多 4 个公开图片 URL 作为结构基准。POST /vectorize 将栅格图转为 SVG/DXF/矢量 PDF，engine 为 lineart（默认，重绘为单描边专利线稿）或 trace（忠实还原像素、保留填充）。POST /enhance 做 AI 超分，scale 取 2 或 4，dpi 取 300 或 600（仅元数据）。POST /convert 输出可提交的栅格，format 取 png/tiff/pdf，dpi 取 300 或 600。后三个端点接受 JSON 的 imageUrl 或 multipart/form-data 文件（PNG/JPEG/WebP/TIFF，≤10 MB）。
使用方式：先设置环境变量 PATENTFIG_API_KEY（密钥以 pfig_ 开头，在 https://patentfig.ai/settings/api-keys 创建），不要硬编码或写入日志。可用 curl -s https://patentfig.ai/api/v1/credits -H "Authorization: Bearer $PATENTFIG_API_KEY" 免费校验连通性与余额。生成示例：curl -s -X POST https://patentfig.ai/api/v1/figures -H "Authorization: Bearer $PATENTFIG_API_KEY" -H "Content-Type: application/json" --max-time 300 -d '{"prompt": "...", "output": "svg", "labeled": true}'。提示词中应明确列出要绘制的部件名称；流程图/框图需逐一列出每个节点。
限制与计费：/figures 10 积分，/vectorize、/enhance、/convert 各 20 积分；仅成功时扣费，失败重试不重复计费。速率限制 60 请求/分钟/密钥，遇 429 从 5 秒起退避重试；402 INSUFFICIENT_CREDITS 应停止并提示用户在 https://patentfig.ai/pricing 充值；500 GENERATION_FAILED 可重试一次，持续失败通常说明输入不适合该流程。客户端超时至少设 300 秒，生成与矢量化约需 20 秒至数分钟。批量计费调用前先查 GET /credits 确认余额。完整参数表见 references/endpoints.md，机器可读规范见 https://patentfig.ai/api/openapi.yaml。