API para desarrolladores

Inicio rápido

Incluye userNo y API Key en cada solicitud. La carga es opcional: usa /open/uploadVideo o proporciona directamente una videoUrl pública.

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'

Convenciones

Estados de tarea

Las respuestas incluyen code y message. Las tareas pasan por waiting y processing hasta success o failed. Si finalizan correctamente, usa resultUrl; si fallan, revisa failCode. Los archivos de resultado caducan.

Gestiona los errores con code, message, status, failCode y refundStatus.

Ejemplos de integración

Elige el flujo que mejor encaje con tu producto. Cada paso enlaza directamente con la referencia de API.

Endpoints disponibles

Campos comunes de solicitud

Campos de la tarea de vídeo

Respuesta y estado de la tarea

Las respuestas incluyen code y message. Las tareas pasan por waiting y processing hasta success o failed. Si finalizan correctamente, usa resultUrl; si fallan, revisa failCode. Los archivos de resultado caducan.

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

Códigos de error

Identificadores de fallas de tareas (failCode)

failCode es un identificador de cadena, no el code numérico. Aparece sólo cuando falla una tarea. Utilice failCode para determinar la causa; no analice el mensaje failReason traducido.

Copiar ejemplo y llamar

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

Uso y facturación

La eliminación de subtítulos de vídeo se factura según la duración y la resolución. Las imágenes cuestan 10 créditos por tarea completada; los fallos de procesamiento no se cobran.

Las consultas de tareas solo devuelven datos del usuario autenticado.

Gestiona los errores con code, message, status, failCode y refundStatus.

Comprar créditos

La eliminación de subtítulos de vídeo se factura según la duración y la resolución. Las imágenes cuestan 10 créditos por tarea completada; los fallos de procesamiento no se cobran.