Skip to content
واجهة برمجة التطبيقات للمطورين

واجهة برمجة تطبيقات AMPX

أتمت تحويل الملفات ومهام الأدوات ومعالجة النتائج عبر REST API واضح.

POST /api/convert

الوصول إلى نظام المعلومات الإدارية المتكامل هو إضافة مدفوعة

Choose Starter, Basic or Pro, then add the API key to that same monthly Stripe involvement. ويستخدم مؤشر الأداء الموحد نفس رصيد الحساب الائتماني والحد الأقصى للمعدل الذي تستخدمه أدوات الشبكة.

سير العمل

تنزيلات URL تبدأ في الخطوة 2. المحولات المتحركة أول محميات وملفات تحميل بحم

مفتاح الدببة الواحدة؛ حدود الخطة المشتركة
1
ملفات توزيع وتحميل

الاستخدام POST /api/uploads, ثم تحميل مع التذاكر إلى العائدين upload_url. مطلوب فقط ل imagick, esrgan, video_convert, audio_convert, archive, pandoc.

2
تقديم العملية

أرسل POST /api/convert مع خدمة type (و) إما مصدر أو بيانات تحميل مخصصة.

3
Poll owned job status

اتصل GET /api/status?token=... حتى الولاية finished, failed أو cancelled. The token is scoped to the API key that created it.

4
تحميل النتيجة

إستعملْ المعادَ download_url أو GET /d/{token}. وتعود مرافق الوحدة والنص بصورة متزامنة وتفويض عملية الاقتراع.

Starter

الائتمانات/دورة إعداد الفواتير10,000
الحد الأقصى للمعدل10/min
مفتاح APIمبالغ مضافة منفصلة

Basic

الائتمانات/دورة إعداد الفواتير25,000
الحد الأقصى للمعدل30/min
مفتاح APIمبالغ مضافة منفصلة

Pro

الائتمانات/دورة إعداد الفواتير60,000
الحد الأقصى للمعدل60/min
مفتاح APIمبالغ مضافة منفصلة

الخدمات المتاحة وأسعار الائتمان

الائتمانات لا تُحمل إلا عندما تنجح العملية فالوظائف المتخلفة أو الملغاة تفرج عن تحفظها. وتضيف عمليات الشحن الحجمي المبيّن لكل مدخل نهائي من طراز 10 MB.

الخدماتالنوعالائتمانات الأساسيةرسوم الحجم النهائيالحالة
تحميل الفيديو
Download video from YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo or another supported source.
العمل 12 +1 / بدأت 10 MB Available
تحميل الصوت
Extract audio from a supported media URL.
العمل 8 +1 / بدأت 10 MB Available
محول الصور ومحرر للجملة
تحويل وإحياء ومحاصيل وتناوب وتحرير صورة أو أكثر من الصور المحملة.
العمل 5 +1 / بدأت 10 MB Available
محول الصوت
حوّل ملف صوتي محشو
العمل 5 +1 / بدأت 10 MB Available
محول فيديو
Convert an uploaded video with an allowlisted FFmpeg preset for YouTube, Instagram Reels or TikTok Shorts.
العمل 12 +1 / بدأت 10 MB العجز المؤقت
محولات المحفوظات
إنشاء أو تحويل محفوظات محملة.
العمل 5 +1 / بدأت 10 MB Available
محول الوثائق
Convert a supported uploaded document with Pandoc.
العمل 5 +1 / بدأت 10 MB العجز المؤقت
AI image upscaler
تحديث صورة محملة بنموذج مدعم من طراز ESRGAN.
العمل 25 +1 / بدأت 10 MB Available
جهاز تحقق من طراز Proxy
تحقق من دفعة من HTTP أو HTTPS أو SOCKS proxies.
العمل 1 / 5 البنود لا Available
محول وحدة
الرمز عملية تحويل وحدة
الفائدة 1 لا Available
مرافق النصوص
الرمز تشغيل مرافق النصوص.
الفائدة 1 لا Available

التوثيق

أرسل المفتاح كسيارة بيرة ولا يظهر إلا مرة واحدة عندما يخلق أو يتناوب.

Authorization: Bearer ampx_live_...

القيود والرسوم

ويستخدم المفتاح نفس الائتمانات والعمليات/الحد الأقصى للدقة التي يستخدمها حساب الإنترنت. وتُحمَّل المنفعة الناجحة على الفور؛ وتُخصَّص اعتمادات احتياطية وظيفية غير متكافئة وتسويها بعد إتمامها.

أطباء قابلين للقراءة

أحضروا المصادق عليه 3.1 وثيقة مع نفس رئيس البير

GET https://ampx.cc/api/openapi.json

الخدمات المرجعية

وترد أدناه قائمة بجميع عمليات المبادرة والميادين المطلوبة. مضافا إليها Idempotency-Key عند إعادة طلب.

POST /api/uploads — توزيع الملفات

For imagick, esrgan, video_convert, audio_convert, archive, pandoc, أوّلًا تُخصّص لقبًا أو أكثر. تحميل كل ملف مع حوزة إلى الخلف upload_url, الحفاظ على البيانات الوصفية الملفية ثمّ يُقدّمُ المعادَ، أَو files[].relative_path إلى باندوك /api/convert.

curl -X POST 'https://ampx.cc/api/uploads' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"mode":"imagick","filenames":["input.png"]}'
{
  "ok": true,
  "data": {
    "token": "UPLOAD_TOKEN",
    "worker": "worker1",
    "files": [{"name": "input.png", "relative_path": "UPLOAD_TOKEN/input.png"}],
    "upload_url": "https://worker.example/api/upload/tus",
    "protocol": "tus"
  }
}

حمولة بالبدلات 1.0: إنشاء موارد تحميل upload_url. كلاهما token و filename في Upload-Metadata هي القيم الأساسية 64 The response returns the resumable resource URL in its Location رأس.

curl -i -X POST '<UPLOAD_URL>' \ -H 'Tus-Resumable: 1.0.0' \ -H 'Upload-Length: <FILE_SIZE_BYTES>' \ -H 'Upload-Metadata: token <BASE64_UPLOAD_TOKEN>,filename <BASE64_FILENAME>'

تحميل من خلال ذلك Location. إذا استأنف النقل، الحصول على التعويض الحالي ببدلة HEAD الطلب وإرسال تلك القيمة Upload-Offset.

curl -X PATCH '<LOCATION_FROM_POST>' \ -H 'Tus-Resumable: 1.0.0' \ -H 'Content-Type: application/offset+octet-stream' \ -H 'Upload-Offset: 0' \ --data-binary '@input.png'
POST /api/convert — تحميل الفيديو

Download video from YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo or another supported source. السعر الأساسي: 12 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.

الميدانالنوع/الشرط
typestring|required
urlstring|required
formatstring|optional
qualitystring|optional
fpsinteger|optional
playlistboolean|optional
source_servicestring|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"video","url":"https://www.youtube.com/watch?v=VIDEO_ID","format":"mp4","quality":"1080p","playlist":false,"source_service":"youtube"}'

A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.

POST /api/convert — تحميل الصوت

Extract audio from a supported media URL. السعر الأساسي: 8 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.

الميدانالنوع/الشرط
typestring|required
urlstring|required
formatmp3|m4a|flac|aac
qualitystring|optional
playlistboolean|optional
source_servicestring|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"audio","url":"https://soundcloud.com/artist/track","format":"mp3","quality":"320","playlist":false,"source_service":"soundcloud"}'

A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.

POST /api/convert — محول الصور ومحرر للجملة

تحويل وإحياء ومحاصيل وتناوب وتحرير صورة أو أكثر من الصور المحملة. السعر الأساسي: 5 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.

الميدانالنوع/الشرط
typestring|required
tokenstring|required (from POST /api/uploads)
output_formatstring|required
operationsobject|optional (auto_orient, trim, strip, quality, rotate, flip, flop, invert, resize, fit or pad)
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"imagick","token":"UPLOAD_TOKEN","output_format":"webp","operations":{"auto_orient":true,"invert":true,"resize":"1920x1080>","quality":85}}'

A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.

POST /api/convert — محول الصوت

حوّل ملف صوتي محشو السعر الأساسي: 5 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.

الميدانالنوع/الشرط
typestring|required
tokenstring|required (from POST /api/uploads)
output_formatstring|required
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"audio_convert","token":"UPLOAD_TOKEN","output_format":"mp3"}'

A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.

POST /api/convert — محول فيديو

Convert an uploaded video with an allowlisted FFmpeg preset for YouTube, Instagram Reels or TikTok Shorts. السعر الأساسي: 12 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.

الميدانالنوع/الشرط
typestring|required
tokenstring|required (from POST /api/uploads)
output_formatmp4|webm|required
presetyoutube|instagram_reels|tiktok_shorts|square_mp4|classic_4_3|widescreen_16_9|generic_mp4|generic_webm|optional
aspect_ratiopreset|source|1:1|4:3|16:9|9:16|optional
fit_modepad|crop|stretch|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"video_convert","token":"UPLOAD_TOKEN","output_format":"mp4","preset":"youtube"}'

A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.

POST /api/convert — محولات المحفوظات

إنشاء أو تحويل محفوظات محملة. السعر الأساسي: 5 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.

الميدانالنوع/الشرط
typestring|required
tokenstring|required (from POST /api/uploads)
output_formatstring|required
max_output_bytesinteger|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"archive","token":"UPLOAD_TOKEN","output_format":"zip"}'

A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.

POST /api/convert — محول الوثائق

Convert a supported uploaded document with Pandoc. السعر الأساسي: 5 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.

الميدانالنوع/الشرط
typestring|required
input_pathstring|required (files[].relative_path returned by POST /api/uploads)
from_formatstring|required
to_formatstring|required
workerstring|required (from POST /api/uploads)
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"pandoc","input_path":"UPLOAD_TOKEN/document.docx","from_format":"docx","to_format":"pdf","worker":"worker1"}'

A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.

POST /api/convert — AI image upscaler

تحديث صورة محملة بنموذج مدعم من طراز ESRGAN. السعر الأساسي: 25 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.

الميدانالنوع/الشرط
typestring|required
tokenstring|required (from POST /api/uploads)
modelstring|optional
scaleinteger|optional (2-4)
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"esrgan","token":"UPLOAD_TOKEN","model":"realesrgan-x4plus","scale":4}'

A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.

POST /api/convert — جهاز تحقق من طراز Proxy

تحقق من دفعة من HTTP أو HTTPS أو SOCKS proxies. السعر الأساسي: 1 credit(s).

الميدانالنوع/الشرط
typestring|required
proxiesarray|required
default_protocolstring|optional
timeout_secinteger|optional
connect_timeout_secinteger|optional
test_urlurl|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"proxy_check","proxies":["http://127.0.0.1:8080","socks5://127.0.0.1:1080"],"default_protocol":"http","timeout_sec":15,"connect_timeout_sec":5,"test_url":"https://example.com/"}'

A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.

POST /api/utilities/unit-convert — محول وحدة

الرمز عملية تحويل وحدة السعر الأساسي: 1 credit(s).

الميدانالنوع/الشرط
categorystring|required
fromstring|required
tostring|required
valuenumber|required
precisioninteger|optional
curl -X POST 'https://ampx.cc/api/utilities/unit-convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"category":"length","from":"m","to":"ft","value":10,"precision":4}'

وتستجيب هذه الفائدة على نحو متزامن مع نتائجها واستعمالها المحمل.

POST /api/utilities/text — مرافق النصوص

الرمز تشغيل مرافق النصوص. السعر الأساسي: 1 credit(s).

الميدانالنوع/الشرط
textstring|required
operationsarray|optional
curl -X POST 'https://ampx.cc/api/utilities/text' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"text":"Convert this title","operations":["uppercase","slug"]}'

وتستجيب هذه الفائدة على نحو متزامن مع نتائجها واستعمالها المحمل.

مثال على الوضع والتنزيل

البول فقط status_url عاد من أجل عملك عندما تكون الولاية finished و ready هذا صحيح download_url; وتصدر الوظائف المفقودة والملغاة قروضها المحجوزة.

curl 'https://ampx.cc/api/status?token=JOB_TOKEN' \ -H 'Authorization: Bearer <AMPX_API_KEY>'
{
  "ok": true,
  "data": {
    "token": "JOB_TOKEN",
    "state": "finished",
    "ready": true,
    "download_url": "https://ampx.cc/d/JOB_TOKEN"
  }
}

عقد خطأ

استخدام الأخطاء {"ok":false,"error":{"code":"…","message":"…"}}. ويقتضي الوصول خطة فعالة مدفوعة الأجر بالإضافة إلى الإضافات المنفصلة للبروتوكول الاختياري، أو منحة إدارية مكنت من الوصول إليه.

المدونةHTTP
bearer_token_missing401
invalid_api_key403
paid_plan_required403
api_addon_required403
billing_not_active403
rate_limit_exceeded429
upload_too_large413
credits_exhausted429
idempotency_conflict409
invalid_request422
scope_not_allowed403
service_disabled503
الموقع التحقق...