API dành cho nhà phát triển

Bắt đầu nhanh

Thêm userNo và API Key vào mọi yêu cầu. Tải lên là tùy chọn: dùng /open/uploadVideo hoặc cung cấp trực tiếp videoUrl công khai.

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'

Quy ước

Trạng thái tác vụ

Phản hồi chứa code và message. Tác vụ chuyển từ waiting sang processing rồi đến success hoặc failed. Khi thành công, dùng resultUrl; khi lỗi, kiểm tra failCode. Tệp kết quả sẽ hết hạn.

Xử lý lỗi bằng code, message, status, failCode và refundStatus.

Ví dụ tích hợp

Chọn quy trình phù hợp với sản phẩm của bạn. Mỗi bước liên kết trực tiếp đến tài liệu API.

Các endpoint khả dụng

Các trường yêu cầu chung

Các trường tác vụ video

Phản hồi và trạng thái tác vụ

Phản hồi chứa code và message. Tác vụ chuyển từ waiting sang processing rồi đến success hoặc failed. Khi thành công, dùng resultUrl; khi lỗi, kiểm tra failCode. Tệp kết quả sẽ hết hạn.

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

Mã lỗi

Mã lỗi tác vụ (failCode)

failCode là mã định danh dạng chuỗi, khác với code dạng số, và chỉ xuất hiện khi tác vụ thất bại. Dùng failCode để xác định nguyên nhân; không phân tích nội dung thông báo failReason đã dịch.

Sao chép ví dụ và gọi

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

Sử dụng và thanh toán

Tác vụ video được tính phí theo thời lượng xử lý và độ phân giải. Ảnh tốn 10 điểm cho mỗi tác vụ thành công; xử lý thất bại không bị tính phí.

Truy vấn tác vụ chỉ trả về dữ liệu của người dùng đã xác thực.

Xử lý lỗi bằng code, message, status, failCode và refundStatus.

Mua điểm

Tác vụ video được tính phí theo thời lượng xử lý và độ phân giải. Ảnh tốn 10 điểm cho mỗi tác vụ thành công; xử lý thất bại không bị tính phí.