开发者 API

快速开始

Authenticate every request with your userNo and apiKey. Uploading a video is optional: you may either call /open/uploadVideo first or submit a publicly reachable videoUrl directly.

curl -X POST https://www.550wai.cn/open/submitTask \
  -F userNo=YOUR_USER_NO -F apiKey=YOUR_API_KEY \
  -F videoUrl=https://example.com/video.mp4 \
  -F width=1920 -F height=1080 -F duration=30 \
  -F x1=0 -F y1=0 -F x2=1920 -F y2=200

可用接口

Common request fields

Video submit fields

Response and task status

Every response is a flat JSON object with code and message. Video tasks move through waiting → processing → success or failed. A successful task returns resultUrl; failed tasks include a stable failCode. Results expire according to the platform retention policy.

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

错误码

JavaScript 与 Python

// JavaScript
const form = new FormData();
form.append('userNo', USER_NO);
form.append('apiKey', API_KEY);
form.append('videoUrl', VIDEO_URL);
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
})

使用与计费

Video subtitle removal uses the same credit schedule as the domestic Open API. Images are charged 10 credits per task. Failed processing is not charged; when a post-charge media failure occurs, inspect refundStatus.

Task detail and list responses are scoped to the authenticated user. Video-link watermark removal is not available through the Eraser developer API.

See code, message, status, failCode and refundStatus for robust error handling.