변환 API

인증

설정 → API 키에서 키를 만든 뒤 모든 요청에 포함합니다.

x-api-key: <your key>

변환할 때 API 키 소유자의 잔액에서 10크레딧을 사용합니다. 네 가지 출력 형식이 모두 포함되며 실패한 작업은 자동으로 환불됩니다.

변환 시작

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, 20MB를 넘으면 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", "svg", "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, svg, 구조화 JSON인 ir, PNG 미리보기인 preview를 넣을 수 있습니다. 여러 번 다운로드해도 크레딧을 추가로 사용하지 않습니다.

짧은 시간만 유효한 다운로드 URL로 302 응답을 보낼 수 있습니다. curl에서는 -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

callback_url은 공개된 https URL이어야 합니다. 전송은 두 번까지 시도합니다. 중요한 작업은 작업 API에서도 결과를 확인하세요.

OpenAPI

기계가 읽을 수 있는 전체 명세는 layerback.com/openapi.yaml에 있습니다. Postman에 가져오거나 사용하는 언어의 타입 클라이언트를 만들 수 있습니다.

제한

• PNG / JPEG / WebP, 이미지당 최대 20MB
• 계정당 시간당 20회. 대량 이전이나 자동화는 davie@daviechen.com으로 문의해 주세요
• 생성 파일은 최소 72시간 보관됩니다. 필요한 파일은 미리 내려받으세요