API
أربع نقاط: طلب رابط رفع، إنشاء مهمة تكبير، الاستعلام عن النتيجة، وإعادة المحاولة عند الفشل. مع قواعد المعاملات وحالات المهمة وأخطاء الاستجابة.
POST
واجهة رفع الصور API
/api/img_upload
cURL
curl -X POST https://bigjpg.com/api/img_upload \
-H 'X-API-KEY: YOUR_API_KEY' \
-d 'filename=small.jpg' \
-d 'filetype=image/jpeg'
# Use url from the response to upload the file to R2.
curl -X PUT --upload-file small.jpg \
-H 'Content-Type: image/jpeg' \
'UPLOAD_URL'
Python
import requests
filename = 'small.jpg'
filetype = 'image/jpeg'
r = requests.post(
url='https://bigjpg.com/api/img_upload',
headers={'X-API-KEY': 'YOUR_API_KEY'},
data={'filename': filename, 'filetype': filetype}
)
upload = r.json()
with open(filename, 'rb') as image:
requests.put(
url=upload['url'],
data=image,
headers={'Content-Type': filetype}
)
print(upload['fileurl']) # use as input in the enlarge API
- يمكن للأعضاء المدفوعين استخدام API
- استدعِ هذا المسار باستخدام مفتاح API للحصول على رابط رفع R2 مؤقت ورابط الصورة العام
- ارفع الملف باستخدام PUT ونوع Content-Type نفسه، ثم استخدم fileurl كـ input في واجهة التكبير
- العنوان الأساسي:
https://bigjpg.com
POST
تكبير API
/api/task/
cURL
curl -d '{"style": "art", "noise": "3", "x2": "1", "input": "YOUR_IMAGE_URL"}' \
-H 'X-API-KEY: YOUR_API_KEY' \
https://bigjpg.com/api/task/
Python
import json
import requests
data = {
'style': 'art',
'noise': '3',
'x2': '1',
'file_name': 'small.jpg',
'input': 'YOUR_IMAGE_URL'
}
r = requests.post(
url='https://bigjpg.com/api/task/',
headers={'X-API-KEY': 'YOUR_API_KEY'},
data=json.dumps(data)
)
print(r.json())
- JSON format
- style can be 'art', 'photo' which means 'cartoon illustration', 'photo'
- noise can be '-1', '0', '1', '2', '3' which means 'None', 'Low, 'Medium', 'High', 'Highest'
- x2 can be '1', '2', '3', '4' which means 2x, 4x, 8x, 16x
- input your enlarge image url
- عند النجاح تُرجَع tid (معرّف المهمة) وminute (الوقت المتوقع) وremaining_api_calls (عدد الاستدعاءات المتبقية).
GET
نتيجة الاستعلام API
/api/task/{task_ids}
cURL
curl https://bigjpg.com/api/task/tid1,tid2,tid3,tid100
Python
import requests
r = requests.get(
url='https://bigjpg.com/api/task/tid1,tid2,tid3,tid100'
)
print(r.json())
- يمكن تمرير أكثر من معرّف مهمة مفصولاً بفواصل — حتى 100 في الطلب الواحد.
- كل مهمة تُرجَع بالشكل {"status": ..., "url": ..., "size": ...} وقيم status هي new وprocess وsuccess وerror.
- تبقى url وsize فارغتين حتى تنتهي المهمة.
POST
إعادة محاولة المهمة API
/api/task/{task_ids}
cURL
curl -X POST https://bigjpg.com/api/task/tid1,tid2,tid3,tid100
Python
import requests
r = requests.post(
url='https://bigjpg.com/api/task/tid1,tid2,tid3,tid100'
)
print(r.json())
أخطاء الاستجابة
status
- valid_api_key_required — ترويسة X-API-KEY مفقودة أو غير معروفة. تحقق من اسم الترويسة ومن أن المفتاح يخص حساباً مدفوعاً ساري المفعول.
- requires_vip — الحساب مجاني أو منتهي. تحتاج واجهة API إلى خطة مدفوعة فعّالة.
- month_limit — استُهلكت حصة الشهر. كل استدعاء ناجح يعيد remaining_api_calls، فيمكنك متابعتها قبل النفاد.
- param_error — القيم خارج النطاق: style يجب أن يكون art أو photo، وnoise من -1 إلى 3، وx2 من 1 إلى 4 (1 إلى 2 للحسابات المجانية).
- input_url_error — يجب أن يكون input رابط صورة http:// أو https:// متاحاً للعموم.
X-API-KEY: يمكن للأعضاء المدفوعين استخدام API
اتصل بنا عن طريق i@bigjpg.com i@bigjpg.com لمزيد من استدعاءات API