Developer API

Snel starten

Voeg userNo en API Key toe aan elke aanvraag. Uploaden is optioneel: gebruik /open/uploadVideo of geef rechtstreeks een openbare videoUrl op.

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'

Conventies

Taakstatussen

Antwoorden bevatten code en message. Taken gaan van waiting naar processing en daarna naar success of failed. Gebruik bij succes resultUrl en controleer bij een fout failCode. Resultaatbestanden verlopen.

Verwerk fouten met code, message, status, failCode en refundStatus.

Integratievoorbeelden

Kies de workflow die bij je product past. Elke stap verwijst rechtstreeks naar de API-referentie.

Beschikbare endpoints

Algemene aanvraagvelden

Velden voor videotaken

Antwoord- en taakstatus

Antwoorden bevatten code en message. Taken gaan van waiting naar processing en daarna naar success of failed. Gebruik bij succes resultUrl en controleer bij een fout failCode. Resultaatbestanden verlopen.

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

Foutcodes

Identificaties voor taakfouten (failCode)

failCode is een string-ID, niet de numerieke code. Het verschijnt alleen als een taak mislukt. Gebruik failCode om de oorzaak te achterhalen; parseer het vertaalde failReason-bericht niet.

Voorbeeld kopiëren en aanroepen

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

Gebruik en facturering

Videotaken worden berekend op basis van verwerkingsduur en resolutie. Afbeeldingen kosten 10 credits per geslaagde taak; mislukte verwerking wordt niet aangerekend.

Taakopvragingen geven alleen gegevens van de geverifieerde gebruiker terug.

Verwerk fouten met code, message, status, failCode en refundStatus.

Credits kopen

Videotaken worden berekend op basis van verwerkingsduur en resolutie. Afbeeldingen kosten 10 credits per geslaagde taak; mislukte verwerking wordt niet aangerekend.