API développeur

Démarrage rapide

Ajoutez userNo et API Key à chaque requête. Le téléversement est facultatif : utilisez /open/uploadVideo ou fournissez directement une videoUrl publique.

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'

Conventions

États de tâche

Les réponses contiennent code et message. Les tâches passent de waiting à processing, puis à success ou failed. En cas de réussite, utilisez resultUrl ; en cas d’échec, consultez failCode. Les fichiers de résultat expirent.

Gérez les erreurs avec code, message, status, failCode et refundStatus.

Exemples d’intégration

Choisissez le parcours adapté à votre produit. Chaque étape renvoie directement à la référence de l’API.

Endpoints disponibles

Champs de requête communs

Champs de tâche vidéo

Réponse et état de la tâche

Les réponses contiennent code et message. Les tâches passent de waiting à processing, puis à success ou failed. En cas de réussite, utilisez resultUrl ; en cas d’échec, consultez failCode. Les fichiers de résultat expirent.

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

Codes d’erreur

Identificateurs d'échec de tâche (failCode)

failCode est un identifiant de chaîne, pas le code numérique. Il apparaît uniquement lorsqu'une tâche échoue. Utilisez failCode pour déterminer la cause ; n'analysez pas le message failReason traduit.

Copier l’exemple et appeler

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

Utilisation et facturation

Les tâches vidéo sont facturées selon la durée de traitement et la résolution. Une image coûte 10 crédits par tâche réussie ; aucun crédit n’est débité en cas d’échec.

Les requêtes de tâche ne renvoient que les données de l’utilisateur authentifié.

Gérez les erreurs avec code, message, status, failCode et refundStatus.

Acheter des crédits

Les tâches vidéo sont facturées selon la durée de traitement et la résolution. Une image coûte 10 crédits par tâche réussie ; aucun crédit n’est débité en cas d’échec.