Developer-API

Schnellstart

Senden Sie bei jeder Anfrage userNo und API Key. Der Upload ist optional: Verwenden Sie /open/uploadVideo oder geben Sie direkt eine öffentliche videoUrl an.

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'

Konventionen

Aufgabenstatus

Antworten enthalten code und message. Aufgaben wechseln von waiting über processing zu success oder failed. Verwenden Sie bei Erfolg resultUrl und prüfen Sie bei Fehlern failCode. Ergebnisdateien laufen ab.

Behandeln Sie Fehler mit code, message, status, failCode und refundStatus.

Integrationsbeispiele

Wählen Sie den passenden Ablauf für Ihr Produkt. Jeder Schritt führt direkt zur API-Referenz.

Verfügbare Endpunkte

Allgemeine Anfragefelder

Felder für Videoaufgaben

Antwort- und Aufgabenstatus

Antworten enthalten code und message. Aufgaben wechseln von waiting über processing zu success oder failed. Verwenden Sie bei Erfolg resultUrl und prüfen Sie bei Fehlern failCode. Ergebnisdateien laufen ab.

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

Fehlercodes

Task-Fehler-IDs (failCode)

failCode ist ein String-Bezeichner, nicht der numerische Wert code. Es erscheint nur, wenn eine Aufgabe fehlschlägt. Verwenden Sie failCode, um die Ursache zu ermitteln. Analysieren Sie die übersetzte failReason-Nachricht nicht.

Beispiel kopieren und aufrufen

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

Nutzung und Abrechnung

Videoaufgaben werden nach Verarbeitungsdauer und Auflösung berechnet. Bilder kosten 10 Credits pro erfolgreicher Aufgabe; fehlgeschlagene Verarbeitung wird nicht berechnet.

Aufgabenabfragen geben nur Daten des authentifizierten Benutzers zurück.

Behandeln Sie Fehler mit code, message, status, failCode und refundStatus.

Credits kaufen

Videoaufgaben werden nach Verarbeitungsdauer und Auflösung berechnet. Bilder kosten 10 Credits pro erfolgreicher Aufgabe; fehlgeschlagene Verarbeitung wird nicht berechnet.