डेवलपर 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 क्रेडिट लगते हैं; विफल प्रोसेसिंग पर शुल्क नहीं लगता।