API Pengembang

Mulai cepat

Sertakan userNo dan API Key pada setiap permintaan. Unggahan bersifat opsional: gunakan /open/uploadVideo atau berikan videoUrl publik secara langsung.

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'

Konvensi

Status tugas

Respons berisi code dan message. Tugas bergerak dari waiting ke processing, lalu success atau failed. Saat berhasil gunakan resultUrl; saat gagal periksa failCode. File hasil memiliki masa berlaku.

Tangani kesalahan dengan code, message, status, failCode, dan refundStatus.

Contoh integrasi

Pilih alur yang sesuai dengan produk Anda. Setiap langkah terhubung langsung ke referensi API.

Endpoint yang tersedia

Kolom permintaan umum

Kolom tugas video

Respons dan status tugas

Respons berisi code dan message. Tugas bergerak dari waiting ke processing, lalu success atau failed. Saat berhasil gunakan resultUrl; saat gagal periksa failCode. File hasil memiliki masa berlaku.

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

Kode kesalahan

Pengidentifikasi kegagalan tugas (failCode)

failCode adalah pengidentifikasi string, bukan code numerik. Tampaknya hanya ketika tugas gagal. Gunakan failCode untuk menentukan penyebabnya; jangan menguraikan pesan 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 penagihan

Tugas video ditagih berdasarkan durasi pemrosesan dan resolusi. Gambar dikenai 10 kredit per tugas berhasil; pemrosesan gagal tidak dikenai biaya.

Kueri tugas hanya mengembalikan data pengguna yang terautentikasi.

Tangani kesalahan dengan code, message, status, failCode, dan refundStatus.

Beli Kredit

Tugas video ditagih berdasarkan durasi pemrosesan dan resolusi. Gambar dikenai 10 kredit per tugas berhasil; pemrosesan gagal tidak dikenai biaya.