Developer API

เริ่มต้นใช้งาน

ใส่ userNo และ API Key ในทุกคำขอ การอัปโหลดเป็นทางเลือก: ใช้ /open/uploadVideo หรือระบุ videoUrl สาธารณะโดยตรง

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'

ข้อกำหนดทั่วไป

สถานะงาน

การตอบกลับประกอบด้วย code และ message งานจะเปลี่ยนจาก waiting เป็น processing แล้วจบด้วย success หรือ failed เมื่อสำเร็จให้ใช้ resultUrl และเมื่อผิดพลาดให้ตรวจสอบ failCode ไฟล์ผลลัพธ์มีวันหมดอายุ

จัดการข้อผิดพลาดด้วย code, message, status, failCode และ refundStatus

ตัวอย่างการเชื่อมต่อ

เลือกขั้นตอนที่เหมาะกับผลิตภัณฑ์ของคุณ แต่ละขั้นตอนเชื่อมไปยังเอกสารอ้างอิง API โดยตรง

Endpoint ที่ใช้ได้

ฟิลด์คำขอทั่วไป

ฟิลด์งานวิดีโอ

การตอบกลับและสถานะงาน

การตอบกลับประกอบด้วย code และ message งานจะเปลี่ยนจาก waiting เป็น processing แล้วจบด้วย success หรือ failed เมื่อสำเร็จให้ใช้ resultUrl และเมื่อผิดพลาดให้ตรวจสอบ failCode ไฟล์ผลลัพธ์มีวันหมดอายุ

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

รหัสข้อผิดพลาด

ตัวระบุความล้มเหลวของงาน (failCode)

failCode เป็นตัวระบุสตริง ไม่ใช่ตัวเลข code จะปรากฏเฉพาะเมื่องานล้มเหลวเท่านั้น ใช้ failCode เพื่อหาสาเหตุ อย่าแยกวิเคราะห์ข้อความ failReason ที่แปลแล้ว

คัดลอกตัวอย่างและเรียกใช้

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

การใช้งานและการเรียกเก็บเงิน

งานวิดีโอคิดค่าบริการตามระยะเวลาประมวลผลและความละเอียด รูปภาพคิด 10 เครดิตต่องานที่สำเร็จ และไม่คิดค่าประมวลผลที่ล้มเหลว

การค้นหางานจะส่งคืนเฉพาะข้อมูลของผู้ใช้ที่ยืนยันตัวตนแล้ว

จัดการข้อผิดพลาดด้วย code, message, status, failCode และ refundStatus

ซื้อเครดิต

งานวิดีโอคิดค่าบริการตามระยะเวลาประมวลผลและความละเอียด รูปภาพคิด 10 เครดิตต่องานที่สำเร็จ และไม่คิดค่าประมวลผลที่ล้มเหลว