Chuyển đến nội dung
Bài viết

API: bắt đầu nhanh

Tự động xử lý ảnh và PDF bằng REST API.

Truy cập và khóa

Đăng nhập Levomio và tạo khóa trong phần cài đặt. Sao chép khóa và thay YOUR_API_KEY trong ứng dụng đã chọn. Giữ bí mật khóa.

Quản lý khóa · API

API: bắt đầu nhanh

Ví dụ chuyển photo.png sang WebP với 1 tín dụng. Đặt LEVOMIO_API_KEY bằng khóa của bạn rồi chạy các lệnh trong cùng một terminal. Cần Bash, curl và uuidgen.

1. Tạo tác vụ

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. Tải ảnh lên

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. Bắt đầu — tối đa 1 tín dụng

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. Lấy kết quả

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

Lặp lại yêu cầu cuối mỗi 1–2 giây đến khi status là completed. Đặt DOWNLOAD_PATH bằng outputs[].downloadUrl của tệp đã sẵn sàng rồi tải xuống bằng lệnh dưới đây.

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

Giá theo tín dụng

Thao tácChi phí
Nén hoặc chuyển đổi ảnh1 tín dụng cho mỗi ảnh và định dạng đầu ra
Ảnh sang PDF1 tín dụng cho mỗi ảnh nguồn, PDF gộp hoặc riêng
Nén PDF1 tín dụng cho mỗi trang PDF nguồn, do máy chủ đếm

10 ảnh sang WebP và AVIF tốn 20 tín dụng; 10 ảnh thành một PDF tốn 10; nén PDF 30 trang tốn 30.

Tải lên, báo giá, kiểm tra số dư và trạng thái, xem trước, tải xuống và ZIP đều miễn phí. Không cần gói đăng ký; giá và giới hạn giống nhau cho mọi tài khoản.

Tín dụng được trừ khi bắt đầu xử lý. maxCredits giới hạn chi phí. Với nhiều tệp, xem tổng bằng quote trước start. Thử lại cùng tác vụ với cùng ID và tham số để không trả phí cho tác vụ mới.

50.000.000 byte mỗi tệp, 250 nguồn mỗi tác vụ. Bản nháp và kết quả được giữ 2 giờ; kiểm tra expiresAt và tải xuống kịp thời. Hạn ngạch trang web không áp dụng cho API/MCP.