개발자 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 레퍼런스로 바로 이동할 수 있습니다.

사용 가능한 엔드포인트

공통 요청 필드

동영상 작업 필드

응답 및 작업 상태

응답에는 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크레딧이며 처리 실패 시 차감되지 않습니다.