الاستخدام POST /api/uploads, ثم تحميل مع التذاكر إلى العائدين upload_url. مطلوب فقط ل imagick, esrgan, video_convert, audio_convert, archive, pandoc.
واجهة برمجة تطبيقات AMPX
أتمت تحويل الملفات ومهام الأدوات ومعالجة النتائج عبر REST API واضح.
الوصول إلى نظام المعلومات الإدارية المتكامل هو إضافة مدفوعة
Choose Starter, Basic or Pro, then add the API key to that same monthly Stripe involvement. ويستخدم مؤشر الأداء الموحد نفس رصيد الحساب الائتماني والحد الأقصى للمعدل الذي تستخدمه أدوات الشبكة.
سير العمل
تنزيلات URL تبدأ في الخطوة 2. المحولات المتحركة أول محميات وملفات تحميل بحم
أرسل POST /api/convert مع خدمة type (و) إما مصدر أو بيانات تحميل مخصصة.
اتصل GET /api/status?token=... حتى الولاية finished, failed أو cancelled. The token is scoped to the API key that created it.
إستعملْ المعادَ download_url أو GET /d/{token}. وتعود مرافق الوحدة والنص بصورة متزامنة وتفويض عملية الاقتراع.
Starter
Basic
Pro
الخدمات المتاحة وأسعار الائتمان
الائتمانات لا تُحمل إلا عندما تنجح العملية فالوظائف المتخلفة أو الملغاة تفرج عن تحفظها. وتضيف عمليات الشحن الحجمي المبيّن لكل مدخل نهائي من طراز 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 |
التوثيق
أرسل المفتاح كسيارة بيرة ولا يظهر إلا مرة واحدة عندما يخلق أو يتناوب.
القيود والرسوم
ويستخدم المفتاح نفس الائتمانات والعمليات/الحد الأقصى للدقة التي يستخدمها حساب الإنترنت. وتُحمَّل المنفعة الناجحة على الفور؛ وتُخصَّص اعتمادات احتياطية وظيفية غير متكافئة وتسويها بعد إتمامها.
أطباء قابلين للقراءة
أحضروا المصادق عليه 3.1 وثيقة مع نفس رئيس البير
الخدمات المرجعية
وترد أدناه قائمة بجميع عمليات المبادرة والميادين المطلوبة. مضافا إليها Idempotency-Key عند إعادة طلب.
POST /api/uploads — توزيع الملفات
For imagick, esrgan, video_convert, audio_convert, archive, pandoc, أوّلًا تُخصّص لقبًا أو أكثر. تحميل كل ملف مع حوزة إلى الخلف upload_url, الحفاظ على البيانات الوصفية الملفية ثمّ يُقدّمُ المعادَ، أَو files[].relative_path إلى باندوك /api/convert.
{
"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 رأس.
تحميل من خلال ذلك Location. إذا استأنف النقل، الحصول على التعويض الحالي ببدلة HEAD الطلب وإرسال تلك القيمة Upload-Offset.
POST /api/convert — تحميل الفيديو
Download video from YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo or another supported source. السعر الأساسي: 12 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.
| الميدان | النوع/الشرط |
|---|---|
type | string|required |
url | string|required |
format | string|optional |
quality | string|optional |
fps | integer|optional |
playlist | boolean|optional |
source_service | string|optional |
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 بروميد الميثيل في الناتج النهائي.
| الميدان | النوع/الشرط |
|---|---|
type | string|required |
url | string|required |
format | mp3|m4a|flac|aac |
quality | string|optional |
playlist | boolean|optional |
source_service | string|optional |
A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.
POST /api/convert — محول الصور ومحرر للجملة
تحويل وإحياء ومحاصيل وتناوب وتحرير صورة أو أكثر من الصور المحملة. السعر الأساسي: 5 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.
| الميدان | النوع/الشرط |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
operations | object|optional (auto_orient, trim, strip, quality, rotate, flip, flop, invert, resize, fit or pad) |
A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.
POST /api/convert — محول الصوت
حوّل ملف صوتي محشو السعر الأساسي: 5 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.
| الميدان | النوع/الشرط |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
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 بروميد الميثيل في الناتج النهائي.
| الميدان | النوع/الشرط |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | mp4|webm|required |
preset | youtube|instagram_reels|tiktok_shorts|square_mp4|classic_4_3|widescreen_16_9|generic_mp4|generic_webm|optional |
aspect_ratio | preset|source|1:1|4:3|16:9|9:16|optional |
fit_mode | pad|crop|stretch|optional |
A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.
POST /api/convert — محولات المحفوظات
إنشاء أو تحويل محفوظات محملة. السعر الأساسي: 5 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.
| الميدان | النوع/الشرط |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
max_output_bytes | integer|optional |
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 بروميد الميثيل في الناتج النهائي.
| الميدان | النوع/الشرط |
|---|---|
type | string|required |
input_path | string|required (files[].relative_path returned by POST /api/uploads) |
from_format | string|required |
to_format | string|required |
worker | string|required (from POST /api/uploads) |
A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.
POST /api/convert — AI image upscaler
تحديث صورة محملة بنموذج مدعم من طراز ESRGAN. السعر الأساسي: 25 credit(s), زائد 1 الائتمان (الائتمانات) للبداية 10 بروميد الميثيل في الناتج النهائي.
| الميدان | النوع/الشرط |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
model | string|optional |
scale | integer|optional (2-4) |
A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.
POST /api/convert — جهاز تحقق من طراز Proxy
تحقق من دفعة من HTTP أو HTTPS أو SOCKS proxies. السعر الأساسي: 1 credit(s).
| الميدان | النوع/الشرط |
|---|---|
type | string|required |
proxies | array|required |
default_protocol | string|optional |
timeout_sec | integer|optional |
connect_timeout_sec | integer|optional |
test_url | url|optional |
A successful submission returns token, state, status_url, download_url والمبلغ الدائن المحجوز.
POST /api/utilities/unit-convert — محول وحدة
الرمز عملية تحويل وحدة السعر الأساسي: 1 credit(s).
| الميدان | النوع/الشرط |
|---|---|
category | string|required |
from | string|required |
to | string|required |
value | number|required |
precision | integer|optional |
وتستجيب هذه الفائدة على نحو متزامن مع نتائجها واستعمالها المحمل.
POST /api/utilities/text — مرافق النصوص
الرمز تشغيل مرافق النصوص. السعر الأساسي: 1 credit(s).
| الميدان | النوع/الشرط |
|---|---|
text | string|required |
operations | array|optional |
وتستجيب هذه الفائدة على نحو متزامن مع نتائجها واستعمالها المحمل.
مثال على الوضع والتنزيل
البول فقط status_url عاد من أجل عملك عندما تكون الولاية finished و ready هذا صحيح download_url; وتصدر الوظائف المفقودة والملغاة قروضها المحجوزة.
{
"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_missing | 401 |
invalid_api_key | 403 |
paid_plan_required | 403 |
api_addon_required | 403 |
billing_not_active | 403 |
rate_limit_exceeded | 429 |
upload_too_large | 413 |
credits_exhausted | 429 |
idempotency_conflict | 409 |
invalid_request | 422 |
scope_not_allowed | 403 |
service_disabled | 503 |