转换 API
以编程方式转换图表图片
认证
在 设置 → API Keys 创建密钥,每个请求携带:
x-api-key: <你的密钥>转换计入密钥所有者的积分余额(每次 1 积分,含全部格式),失败自动退回。
创建转换
直接发送图片字节(PNG、JPEG 或 WebP):
curl -X POST https://layerback.com/api/v1/convert \
-H "x-api-key: $LAYERBACK_KEY" \
-H "Content-Type: application/octet-stream" \
--data-binary @diagram.png{ "job_id": "5c048e6f-ec4d-43ad-9eee-0697414d5cef" }余额不足返回 402,超过 20 MB 返回 413,不支持的字节返回 415,
触发小时频控返回 429。
轮询状态
curl https://layerback.com/api/v1/jobs/$JOB_ID \
-H "x-api-key: $LAYERBACK_KEY"{
"job_id": "5c048e6f-…",
"status": "succeeded",
"total_seconds": 46.9,
"formats": ["vsdx", "pptx", "drawio", "ir", "preview"]
}status 依次为 queued → running → succeeded 或 failed。
建议每隔几秒轮询一次,通常 30–60 秒完成。
下载产物
curl -L "https://layerback.com/api/v1/jobs/$JOB_ID/download?format=vsdx" \
-H "x-api-key: $LAYERBACK_KEY" -o diagram.vsdxformat 支持 vsdx、pptx、drawio、ir(结构化图 JSON)和
preview(PNG)。下载免费且可重复。
限制
- 图片最大 20 MB,格式 PNG / JPEG / WebP
- 频控:每账号每小时 20 次转换(需要更高额度请联系我们)
- 产物至少保留 72 小时,请及时下载或按需重新转换
LayerBack文档