콘텐츠로 건너뛰기
게시글

API: 빠른 시작

REST API로 이미지와 PDF 처리를 자동화하세요.

접근과 키

Levomio에 로그인하고 설정에서 키를 만드세요. 키를 복사해 선택한 클라이언트의 YOUR_API_KEY를 바꾸세요. 키를 공개하지 마세요.

키 관리 · API

API: 빠른 시작

이 예제는 1크레딧으로 photo.png를 WebP로 변환합니다. LEVOMIO_API_KEY에 키를 설정한 뒤 같은 터미널에서 명령을 실행하세요. Bash, curl, uuidgen이 필요합니다.

1. 작업 만들기

export LEVOMIO_API_KEY='YOUR_API_KEY'
export LEVOMIO_ORIGIN='https://levomio.com'
TASK_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')
INPUT_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')
OPTIONS='{"formats":["webp"],"zip":{"enabled":true}}'

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" \
  -H 'Content-Type: application/json' \
  --data "{\"taskId\":\"$TASK_ID\",\"type\":\"convert\",\"options\":$OPTIONS}"

2. 이미지 업로드

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID/inputs" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" \
  -F "taskFileInputId=$INPUT_ID" -F 'position=0' -F '[email protected]'

3. 시작 — 최대 1크레딧

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID/start" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" \
  -H 'Content-Type: application/json' \
  --data "{\"inputIds\":[\"$INPUT_ID\"],\"options\":$OPTIONS,\"maxCredits\":1}"

4. 결과 받기

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY"

status가 completed가 될 때까지 마지막 요청을 1~2초마다 반복하세요. 완성된 파일의 outputs[].downloadUrl을 DOWNLOAD_PATH로 설정하고 아래 명령으로 다운로드하세요.

curl --fail-with-body "$LEVOMIO_ORIGIN$DOWNLOAD_PATH" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" --output result.webp

크레딧 가격

작업비용
이미지 압축 또는 변환이미지와 출력 형식 조합당 1크레딧
이미지를 PDF로 변환합치거나 별도로 만들든 원본 이미지당 1크레딧
PDF 압축서버가 확인한 원본 PDF 페이지당 1크레딧

이미지 10개를 WebP와 AVIF로 변환하면 20크레딧, 하나의 PDF로 만들면 10크레딧, 30페이지 PDF 압축은 30크레딧입니다.

업로드, 견적, 잔액·상태 확인, 미리 보기, 다운로드, ZIP은 무료입니다. 구독이 필요 없으며 가격과 한도는 모든 계정에 동일합니다.

크레딧은 처리가 시작될 때 차감됩니다. maxCredits는 지출 한도입니다. 여러 파일은 start 전에 quote로 합계를 확인하세요. 새 작업 비용이 발생하지 않도록 같은 작업, ID, 매개변수로 재시도하세요.

파일당 50,000,000바이트, 작업당 원본 250개입니다. 초안과 결과는 2시간 보관됩니다. expiresAt을 확인하고 제때 다운로드하세요. 웹사이트 할당량은 API/MCP에 적용되지 않습니다.