واجهة API للمطورين

البدء السريع

أدرج userNo وAPI Key في كل طلب. الرفع اختياري: استخدم /open/uploadVideo أو قدّم videoUrl عامًا مباشرةً.

curl -X POST https://www.550wai.cn/open/submitTask \\
  -H 'Content-Type: application/x-www-form-urlencoded' \\
  --data-urlencode 'userNo=YOUR_USER_NO' --data-urlencode 'apiKey=YOUR_API_KEY' \\
  --data-urlencode 'videoUrl=https://example.com/video.mp4' \\
  --data-urlencode 'width=1920' --data-urlencode 'height=1080' --data-urlencode 'duration=30' \\
  --data-urlencode 'x1=0' --data-urlencode 'y1=0' --data-urlencode 'x2=1920' --data-urlencode 'y2=200'

القواعد العامة

حالات المهمة

تتضمن الاستجابات code وmessage. تنتقل المهام من waiting إلى processing ثم إلى success أو failed. عند النجاح استخدم resultUrl، وعند الفشل افحص failCode. تنتهي صلاحية ملفات النتائج.

عالج الأخطاء باستخدام code وmessage وstatus وfailCode وrefundStatus.

أمثلة التكامل

اختر المسار المناسب لمنتجك. يرتبط كلّ جزء مباشرةً بمرجع واجهة API.

نقاط النهاية المتاحة

حقول الطلب المشتركة

حقول مهمة الفيديو

الاستجابة وحالة المهمة

تتضمن الاستجابات code وmessage. تنتقل المهام من waiting إلى processing ثم إلى success أو failed. عند النجاح استخدم resultUrl، وعند الفشل افحص failCode. تنتهي صلاحية ملفات النتائج.

{ "code": 200, "message": "success", "taskId": "...", "status": "waiting" }

رموز الأخطاء

معرفات فشل المهمة (failCode)

failCode هو معرف سلسلة، وليس code الرقمي. يظهر فقط عند فشل المهمة. استخدم failCode لتحديد السبب؛ لا تقم بتحليل رسالة failReason المترجمة.

نسخ المثال واستدعاؤه

/open/submitTask

// JavaScript
const form = new URLSearchParams({
  userNo: USER_NO, apiKey: API_KEY, videoUrl: VIDEO_URL,
  width: '1920', height: '1080', duration: '30',
  x1: '0', y1: '0', x2: '1920', y2: '200'
});
const response = await fetch('https://www.550wai.cn/open/submitTask', {
  method: 'POST',
  body: form,
});

# Python
import requests
r = requests.post('https://www.550wai.cn/open/submitTask', data={
  'userNo': USER_NO, 'apiKey': API_KEY, 'videoUrl': VIDEO_URL,
  'width': 1920, 'height': 1080, 'duration': 30,
  'x1': 0, 'y1': 0, 'x2': 1920, 'y2': 200
})

/open/removeImageWatermark

// JavaScript
const imageFile = document.querySelector('#image-file').files[0];
const imageForm = new FormData();
imageForm.append('userNo', USER_NO);
imageForm.append('apiKey', API_KEY);
imageForm.append('file', imageFile);
imageForm.append('sync', 'true');
const imageResponse = await fetch(
  'https://www.550wai.cn/open/removeImageWatermark',
  { method: 'POST', body: imageForm }
);

# Python
import requests
IMAGE_FILE_PATH = '/path/to/image-file'
with open(IMAGE_FILE_PATH, 'rb') as image:
  r = requests.post(
    'https://www.550wai.cn/open/removeImageWatermark',
    data={'userNo': USER_NO, 'apiKey': API_KEY, 'sync': 'true'},
    files={'file': image}
  )

الاستخدام والفوترة

تُحتسب مهام الفيديو حسب مدة المعالجة والدقة. تكلف الصورة 10 أرصدة لكل مهمة ناجحة، ولا تُخصم أرصدة عند فشل المعالجة.

تعيد استعلامات المهام بيانات المستخدم المصادق عليه فقط.

عالج الأخطاء باستخدام code وmessage وstatus وfailCode وrefundStatus.

شراء الأرصدة

تُحتسب مهام الفيديو حسب مدة المعالجة والدقة. تكلف الصورة 10 أرصدة لكل مهمة ناجحة، ولا تُخصم أرصدة عند فشل المعالجة.