API：快速入门

通过 REST API 自动处理图片和 PDF。

访问与密钥

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"

每隔 1–2 秒重复最后一个请求，直到 status 变为 completed。将 DOWNLOAD_PATH 设为已完成文件的 outputs[].downloadUrl，然后使用以下命令下载。

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 积分；10 张图片合成一个 PDF 需 10 积分；压缩 30 页 PDF 需 30 积分。

上传、报价、余额与状态查询、预览、下载和 ZIP 均免费。无需订阅；所有账户的价格和限制相同。

积分在处理开始时扣除。maxCredits 设置支出上限。批量处理前，先通过 quote 查看总费用，再调用 start。重试时使用相同任务、ID 和参数，以免为新任务付费。

每个文件最多 50,000,000 字节，每个任务最多 250 个源文件。草稿与结果保留 2 小时；请检查 expiresAt 并及时下载。网站配额不适用于 API/MCP。