API: بداية سريعة

الوصول والمفاتيح

سجّل الدخول إلى Levomio وأنشئ مفتاحًا من الإعدادات. انسخه واستبدل YOUR_API_KEY في البرنامج الذي تختاره. احتفظ بالمفتاح سرًا.

API: بداية سريعة

يحوّل هذا المثال photo.png إلى WebP مقابل رصيد واحد. ضع مفتاحك في LEVOMIO_API_KEY ثم نفّذ الأوامر في الطرفية نفسها. تحتاج إلى Bash وcurl وuuidgen.

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}"

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]'

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}"

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

كرّر الطلب الأخير كل ثانية أو ثانيتين حتى تصبح قيمة status هي completed. ضع قيمة outputs[].downloadUrl للملف الجاهز في DOWNLOAD_PATH، ثم نزّله بالأمر التالي.

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

الأسعار بالأرصدة

تحويل 10 صور إلى WebP وAVIF يكلف 20 رصيدًا؛ تحويل 10 صور إلى PDF واحد يكلف 10؛ ضغط PDF من 30 صفحة يكلف 30.

الرفع وتقدير التكلفة وفحص الرصيد والحالة والمعاينات والتنزيلات وZIP مجانية. لا يلزم اشتراك؛ الأسعار والحدود موحدة لجميع الحسابات.