API Upload

April 1, 2026

API Upload

L'API Upload vous permet de téléverser des fichiers vidéo ou audio locaux sur WayinVideo. Après le téléversement, utilisez l'identifiant de fichier retourné comme video_url dans les autres endpoints API.

Abonnement Requis : Le téléversement de fichiers locaux nécessite un abonnement Standard ou supérieur. Limite de Taille de Fichier : Taille maximale par fichier : 5 Go. Formats pris en charge : avi, mp4, mov, webm.

Flux de Téléversement

  1. Demandez une URL de téléversement pré-signée en fournissant les métadonnées du fichier
  2. Téléversez le fichier directement vers l'URL pré-signée via une requête PUT
  3. Utilisez la valeur identity retournée comme video_url dans les appels API suivants

Obtenir une URL de Téléversement

POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file

Corps de la Requête

ParamètreTypeObligatoireDescription
namestringOuiNom du fichier avec son extension (ex. "my-video.mp4")
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"name": "sample-video.mp4"}'

Réponse

{"data": {"upload_url": "https://storage.example.com/upload/presigned-url...", "identity": "file_abc123"}}
ChampTypeDescription
upload_urlstringURL pré-signée pour le téléversement. Expire après 1 heure.
identitystringIdentifiant du fichier à utiliser comme video_url dans les autres APIs

Téléverser le Fichier

curl -X PUT "https://storage.example.com/upload/presigned-url..." \
  -H "Content-Type: video/mp4" \
  --data-binary @/Users/me/Videos/sample-video.mp4

Utiliser le Fichier Téléversé

Chaque identity est valide pendant 24 heures.

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"video_url": "THE_IDENTITY_VALUE", "enable_export": false}'