转换 API

通过 LayerBack API 把图表图片转换成可编辑的 VSDX、PPTX、draw.io 和 SVG 文件，并接入你的工作流。

创建转换

4 MB 以内的图片，直接发送图片字节（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，请求体过大返回 413（请改用下面的上传流程），不支持的字节返回 415，触发小时频控返回 429。

4 MB 以上的图片

请求体上限约 4.5 MB。更大的图片（最大 20 MB）先上传到存储，再用返回的 key 创建转换：

# 1. 获取上传地址（免费，15 分钟内有效）
curl -X POST https://layerback.com/api/v1/uploads \
  -H "x-api-key: $LAYERBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_type": "image/jpeg"}'

{
  "key": "uploads/…/mhx2k1-a8f3c9d2",
  "upload_url": "https://…",
  "method": "PUT",
  "headers": { "Content-Type": "image/jpeg" },
  "expires_in": 900
}

# 2. 用相同的 Content-Type 上传图片
curl -X PUT "$UPLOAD_URL" -H "Content-Type: image/jpeg" --data-binary @photo.jpg

# 3. 创建转换（在这一步扣费，和上面相同）
curl -X POST https://layerback.com/api/v1/convert \
  -H "x-api-key: $LAYERBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "uploads/…/mhx2k1-a8f3c9d2"}'

第 3 步返回同样的 job_id，也支持 callback_url。图片未上传返回 404，超过 20 MB 返回 413。

轮询状态

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", "svg", "ir", "preview"],
  "input_kind": "diagram"
}

status 依次为 queued → running → succeeded 或 failed。建议每隔几秒轮询一次，通常 30–60 秒完成。

input_kind 表示上传图片被识别成的类型：diagram 和 infographic 会重建为可编辑图形； document、table_receipt、screenshot 保留原图并把其中文字替换为可编辑文字； photo 和 id_document 作为图片嵌入。空白图片会失败并返回 "error_code": "blank_input"，积分自动退还。

下载产物

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、svg、ir（结构化图 JSON）和 preview（PNG）。下载免费且可重复。

该接口可能返回 302 跳转到短时效下载链接，请保留 -L 参数（或让你的 HTTP 客户端跟随重定向）。

完成回调（Webhook）

不想轮询？发起转换时带上 callback_url，任务结束（无论成败）我们会向该地址 POST 结果：

curl -X POST "https://layerback.com/api/v1/convert?callback_url=https://your.app/hooks/layerback" \
  -H "x-api-key: $LAYERBACK_KEY" \
  --data-binary @diagram.png

回调内容：

{
  "job_id": "…",
  "status": "succeeded",
  "total_seconds": 31.2,
  "error": null,
  "error_code": null,
  "formats": ["vsdx", "pptx", "drawio", "svg", "ir", "preview"],
  "input_kind": "diagram"
}

callback_url 必须是公网可达的 https 地址。投递最多尝试两次；重要结果请以任务查询接口为准。轮询方式不受影响，可与回调并用。

OpenAPI

完整的机器可读规范： layerback.com/openapi.yaml——可导入 Postman，或用它生成任意语言的类型化客户端。

限制

图片最大 20 MB（超过 4 MB 请用上传流程），格式 PNG / JPEG / WebP
频控：每账号每小时 20 次转换——有批量迁移/自动化管线等更大需求？邮件联系 davie@daviechen.com 获取更高额度与批量价格
产物至少保留 72 小时，请及时下载或按需重新转换

认证

在 设置 → API Keys 创建密钥，每个请求携带：

x-api-key: <你的密钥>

转换计入密钥所有者的积分余额（每次 10 积分，含全部格式），失败自动退回。

创建转换

4 MB 以内的图片，直接发送图片字节（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，请求体过大返回 413（请改用下面的上传流程），不支持的字节返回 415，触发小时频控返回 429。

4 MB 以上的图片

请求体上限约 4.5 MB。更大的图片（最大 20 MB）先上传到存储，再用返回的 key 创建转换：

# 1. 获取上传地址（免费，15 分钟内有效）
curl -X POST https://layerback.com/api/v1/uploads \
  -H "x-api-key: $LAYERBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_type": "image/jpeg"}'

{
  "key": "uploads/…/mhx2k1-a8f3c9d2",
  "upload_url": "https://…",
  "method": "PUT",
  "headers": { "Content-Type": "image/jpeg" },
  "expires_in": 900
}

# 2. 用相同的 Content-Type 上传图片
curl -X PUT "$UPLOAD_URL" -H "Content-Type: image/jpeg" --data-binary @photo.jpg

# 3. 创建转换（在这一步扣费，和上面相同）
curl -X POST https://layerback.com/api/v1/convert \
  -H "x-api-key: $LAYERBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "uploads/…/mhx2k1-a8f3c9d2"}'

第 3 步返回同样的 job_id，也支持 callback_url。图片未上传返回 404，超过 20 MB 返回 413。

轮询状态

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", "svg", "ir", "preview"],
  "input_kind": "diagram"
}

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、svg、ir（结构化图 JSON）和 preview（PNG）。下载免费且可重复。

该接口可能返回 302 跳转到短时效下载链接，请保留 -L 参数（或让你的 HTTP 客户端跟随重定向）。

完成回调（Webhook）

不想轮询？发起转换时带上 callback_url，任务结束（无论成败）我们会向该地址 POST 结果：

curl -X POST "https://layerback.com/api/v1/convert?callback_url=https://your.app/hooks/layerback" \
  -H "x-api-key: $LAYERBACK_KEY" \
  --data-binary @diagram.png

回调内容：

{
  "job_id": "…",
  "status": "succeeded",
  "total_seconds": 31.2,
  "error": null,
  "error_code": null,
  "formats": ["vsdx", "pptx", "drawio", "svg", "ir", "preview"],
  "input_kind": "diagram"
}

callback_url 必须是公网可达的 https 地址。投递最多尝试两次；重要结果请以任务查询接口为准。轮询方式不受影响，可与回调并用。

OpenAPI

完整的机器可读规范： layerback.com/openapi.yaml——可导入 Postman，或用它生成任意语言的类型化客户端。

限制

图片最大 20 MB（超过 4 MB 请用上传流程），格式 PNG / JPEG / WebP
频控：每账号每小时 20 次转换——有批量迁移/自动化管线等更大需求？邮件联系 davie@daviechen.com 获取更高额度与批量价格
产物至少保留 72 小时，请及时下载或按需重新转换

认证

创建转换

4 MB 以上的图片

轮询状态

下载产物

完成回调（Webhook）

OpenAPI

限制

目录

转换 API

认证

创建转换

4 MB 以上的图片

轮询状态

下载产物

完成回调（Webhook）

OpenAPI

限制

目录