API Upload

September 22, 2026

API Upload

L'API Upload vous permet de téléverser des fichiers vidéo locaux sur WayinVideo. Après le téléversement, utilisez l'identifiant de fichier retourné comme video_url dans les autres endpoints API (AI Clipping, Find Moments, Video Summarization, Video Notes, Video Transcription).

Abonnement requis : le téléversement de fichiers locaux nécessite un abonnement Starter ou supérieur. Les limites de taille par fichier et de stockage total varient selon l'abonnement. Consultez la page des Plans d'abonnement pour plus de détails.

Limite de taille : la taille maximale d'un fichier téléversé localement est de 5 Go. Si vous avez besoin d'une limite supérieure, contactez-nous à l'adresse wayinvideo@wayin.ai.

Formats pris en charge : vous devez téléverser un fichier vidéo valide. Les formats actuellement pris en charge sont avi, mp4, mov et webm. Le téléversement d'autres formats peut entraîner l'échec du traitement après la soumission.

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

Utilisez l'upload_url pour téléverser votre fichier à l'aide d'une requête PUT. Dans --data-binary, le caractère @ est suivi du chemin du fichier local :

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

Remarque : si vous effectuez un nouveau téléversement avec la même upload_url, le nouveau fichier remplace le précédent. Chaque fichier ne doit pas dépasser 5 Go.

Utiliser le Fichier Téléversé

Après le téléversement, transmettez la valeur identity comme video_url lors de la soumission de tâches.

Remarque : chaque identity est valide pendant 24 heures. Si votre quota est suffisant, vous pouvez utiliser la même identity pour soumettre plusieurs tâches pendant cette période.

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}'

FAQ

Quand téléverser un fichier local plutôt que de passer une URL source ?

Si votre vidéo existe déjà sur une plateforme prise en charge (YouTube, Vimeo, TikTok, Zoom, etc.), passez l'URL directement à l'endpoint de traitement — aucun téléversement nécessaire. N'utilisez l'API Upload que pour les fichiers qui ne sont pas encore hébergés sur une source prise en charge.

Quelle est la taille maximale d'un fichier téléversé ?

5 Go par fichier. Contactez wayinvideo@wayin.ai si votre cas d'usage nécessite une limite plus élevée.

Quels formats de fichier sont pris en charge ?

mp4, mov, webm, avi. Les autres formats peuvent échouer lors du traitement.

Le téléversement compte-t-il dans le quota de stockage de mon plan ?

Oui — les fichiers téléversés consomment du stockage sur votre plan d'abonnement. Voir Plans d'abonnement pour les limites de stockage et de taille par fichier de chaque plan.

Comment utiliser le fichier téléversé dans d'autres appels API ?

Après le téléversement, passez l'identifiant de fichier retourné comme champ video_url à n'importe quel endpoint de traitement pris en charge — AI Clipping, Find Moments, Video Summarization, Video Notes ou Video Transcription.