API: 빠른 시작
REST API로 이미지와 PDF 처리를 자동화하세요.
접근과 키
Levomio에 로그인하고 설정에서 키를 만드세요. 키를 복사해 선택한 클라이언트의 YOUR_API_KEY를 바꾸세요. 키를 공개하지 마세요.
키 관리 · APIAPI: 빠른 시작
이 예제는 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에 적용되지 않습니다.