Téléversez des Fichiers Locaux pour AI Clipping, Summarization et Transcription

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

Demandez une URL de téléversement pré-signée en fournissant les métadonnées du fichier
Téléversez le fichier directement vers l'URL pré-signée via une requête PUT
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ètre	Type	Obligatoire	Description
`name`	string	Oui	Nom 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"}}

Champ	Type	Description
`upload_url`	string	URL pré-signée pour le téléversement. Expire après 1 heure.
`identity`	string	Identifiant 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}'

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 fichiers audio seuls doivent être muxés dans l'un de ces formats conteneurs avant téléversement. 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 — AI Clipping, Find Moments, Video Summarization ou Video Transcription.