Geliştirici API

Hızlı başlangıç

Her isteğe userNo ve API Key ekleyin. Yükleme isteğe bağlıdır: /open/uploadVideo kullanın veya herkese açık bir videoUrl sağlayın.

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'

Kurallar

Görev durumları

Yanıtlar code ve message içerir. Görevler waiting ve processing aşamalarından geçerek success veya failed olur. Başarıda resultUrl kullanın, hatada failCode değerini inceleyin. Sonuç dosyalarının süresi dolar.

Hataları code, message, status, failCode ve refundStatus ile işleyin.

Entegrasyon örnekleri

Ürününüz için uygun akışı seçin. Her adım doğrudan API referansına bağlanır.

Kullanılabilir uç noktalar

Ortak istek alanları

Video görevi alanları

Yanıt ve görev durumu

Yanıtlar code ve message içerir. Görevler waiting ve processing aşamalarından geçerek success veya failed olur. Başarıda resultUrl kullanın, hatada failCode değerini inceleyin. Sonuç dosyalarının süresi dolar.

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

Hata kodları

Görev hatası tanımlayıcıları (failCode)

failCode, sayısal code değil, bir dize tanımlayıcısıdır. Yalnızca bir görev başarısız olduğunda görünür. Sebebini belirlemek için failCode'yi kullanın; çevrilmiş failReason mesajını ayrıştırmayın.

Örneği kopyala ve çağır

/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}
  )

Kullanım ve faturalandırma

Video görevleri işleme süresi ve çözünürlüğe göre ücretlendirilir. Görseller başarılı görev başına 10 kredidir; başarısız işleme ücretlendirilmez.

Görev sorguları yalnızca kimliği doğrulanmış kullanıcının verilerini döndürür.

Hataları code, message, status, failCode ve refundStatus ile işleyin.

Kredi Satın Al

Video görevleri işleme süresi ve çözünürlüğe göre ücretlendirilir. Görseller başarılı görev başına 10 kredidir; başarısız işleme ücretlendirilmez.