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 קרדיטים למשימה מוצלחת; עיבוד שנכשל אינו מחויב.