LogoLayerBack文档
LogoLayerBack文档
首页

快速开始

快速开始

API

转换 API
X (Twitter)

转换 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.vsdx

format 支持 vsdx、pptx、drawio、ir(结构化图 JSON)和 preview(PNG)。下载免费且可重复。

限制

  • 图片最大 20 MB,格式 PNG / JPEG / WebP
  • 频控:每账号每小时 20 次转换(需要更高额度请联系我们)
  • 产物至少保留 72 小时,请及时下载或按需重新转换

快速开始

把图表图片转换为可编辑的 Visio、PowerPoint 和 draw.io 文件

目录

认证
创建转换
轮询状态
下载产物
限制