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 · APIAPI: 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.webpGiá theo tín dụng
| Thao tác | Chi phí |
|---|---|
| Nén hoặc chuyển đổi ảnh | 1 tín dụng cho mỗi ảnh và định dạng đầu ra |
| Ảnh sang PDF | 1 tín dụng cho mỗi ảnh nguồn, PDF gộp hoặc riêng |
| Nén PDF | 1 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.