API Pembangun

Mula pantas

Sertakan userNo dan API Key dalam setiap permintaan. Muat naik adalah pilihan: gunakan /open/uploadVideo atau berikan videoUrl awam secara terus.

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'

Konvensyen

Status tugas

Respons mengandungi code dan message. Tugas bergerak daripada waiting kepada processing, kemudian success atau failed. Apabila berjaya gunakan resultUrl; apabila gagal semak failCode. Fail hasil mempunyai tempoh luput.

Kendalikan ralat dengan code, message, status, failCode dan refundStatus.

Contoh integrasi

Pilih aliran yang sesuai dengan produk anda. Setiap langkah dipautkan terus ke rujukan API.

Endpoint tersedia

Medan permintaan umum

Medan tugas video

Respons dan status tugas

Respons mengandungi code dan message. Tugas bergerak daripada waiting kepada processing, kemudian success atau failed. Apabila berjaya gunakan resultUrl; apabila gagal semak failCode. Fail hasil mempunyai tempoh luput.

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

Kod ralat

Pengecam kegagalan tugas (failCode)

failCode ialah pengecam rentetan, bukan code angka. Ia muncul hanya apabila tugasan gagal. Gunakan failCode untuk menentukan punca; jangan menghuraikan mesej failReason yang diterjemahkan.

Salin contoh dan panggil

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

Penggunaan dan pengebilan

Tugas video dicaj berdasarkan tempoh pemprosesan dan resolusi. Imej dikenakan 10 kredit bagi setiap tugas berjaya; pemprosesan gagal tidak dicaj.

Pertanyaan tugas hanya mengembalikan data pengguna yang disahkan.

Kendalikan ralat dengan code, message, status, failCode dan refundStatus.

Beli Kredit

Tugas video dicaj berdasarkan tempoh pemprosesan dan resolusi. Imej dikenakan 10 kredit bagi setiap tugas berjaya; pemprosesan gagal tidak dicaj.