Extraire une miniature vidéo
Capturez une miniature JPEG ou WebP à un instant choisi.
POST /api/free/video-thumbnailUtiliser Extraire une miniature vidéo en ligne
Importez, réglez, prévisualisez et téléchargez sans clé API.
1. Import et réglages
Utilisez l’outil sans clé. Les fichiers ne sont envoyés qu’au lancement.
2. Aperçu et téléchargement
L’aperçu, les variations de taille et le téléchargement s’affichent ici
Intégrer via l’API
Seuls les appels programmatiques nécessitent une clé API. Les paramètres, réponses et erreurs sont documentés ci-dessous.
POST /api/free/video-thumbnailL’usage en ligne est sans clé. Les appels programmatiques nécessitent une clé APIAny.
- L’instant doit se trouver dans la durée de la vidéo.
- La largeur est limitée à 1920 pixels.
Réponse
Une requête réussie renvoie une réponse image avec le Content-Type décrit ici.
Erreurs fréquentes
- 400
- Un fichier ou paramètre manque, est invalide ou dépasse une limite.
- 401
- La clé des appels programmatiques manque, est invalide ou désactivée.
- 429
- La limite partagée en ligne ou authentifiée est atteinte.
Paramètres et limites
| Paramètre | Exigence | Défaut | Valeurs acceptées |
|---|---|---|---|
videoFichier vidéo | Requis | — | file |
timestampTemps en secondes | Optionnel | 0 | number |
widthLargeur | Optionnel | 1280 | number |
formatFormat de sortie | Optionnel | webp | webp, jpeg |
Exemple API
Cet exemple authentifié est destiné au code. Le Playground ne demande ni n’expose votre clé.
curl -X POST "https://apiany.ai/api/free/video-thumbnail" \ -H "Authorization: Bearer $API_KEY" \ -F "video=@input.mp4" \ -F "timestamp=2" \ --output thumbnail.webp
Questions fréquentes
Faut-il une clé API pour Extraire une miniature vidéo ?
Non dans le Playground. Les appels programmatiques utilisent Authorization: Bearer ou X-API-Key.
Quelles limites pour Extraire une miniature vidéo ?
En ligne : 3 requêtes par minute et 30 par jour. Les comptes gratuits authentifiés ont 5 RPM et les comptes payants 500 RPM pour toutes les API gratuites.
Quelles entrées accepte Extraire une miniature vidéo ?
Utilisez les champs requis et optionnels du tableau. Les formats non pris en charge et valeurs hors plage sont refusés.
Que renvoie Extraire une miniature vidéo ?
Les requêtes réussies renvoient une réponse image ; les erreurs utilisent les codes HTTP indiqués.