Comment choisir quelle image devient la miniature ?

Passe un timestamp dans l'objet params — soit une chaîne HH:MM:SS.mmm, soit un nombre de secondes. Fotovid se positionne à ce point et extrait cette image. Une pratique courante consiste à échantillonner une ou deux secondes après le début pour éviter les images noires d'intro.

Dans quel format la miniature est-elle renvoyée ?

La réponse est un JSON plat contenant une url hébergée par fotovid pour l'image extraite, plus id, type, et expires_at. Tu pointes ton vers cette url ou tu télécharges les bytes pour la réhéberger.

Dois-je envoyer le fichier vidéo brut ?

Non. Chaque endpoint prend un source_url — l'URL HTTPS de ta vidéo source. Fotovid la récupère côté serveur, donc tu n'as jamais à uploader le fichier via ta propre fonction ni à le streamer dans le corps de la requête.

Dois-je m'appuyer sur l'URL hébergée sur le long terme ?

Considère-la comme un résultat temporaire, pas un stockage permanent. La réponse inclut un expires_at, donc pour tout ce que tu conserves — une galerie ou un flux — télécharge l'image et stocke ta propre copie dans ton bucket ou ton CDN.

En quoi est-ce différent de Cloudinary ou Transloadit ?

Ces plateformes regroupent stockage, pipeline de transformation complet et CDN. Fotovid est découplé et pensé pour les développeurs : un appel HTTP, une seule tâche — extraire une image de couverture — à un prix bas et basé sur l'usage, sans plateforme dans laquelle t'enfermer.

Combien coûte une extraction de miniature ?

La tarification se fait en crédits d'usage : $1 = 100 crédits, et la plupart des opérations, dont extract-cover, coûtent 1 crédit chacune. Tu démarres avec des crédits gratuits, donc l'intégration et les tests initiaux ne coûtent rien.

Miniature vidéo / couverture

API de miniature vidéo : extraire une image de couverture à n'importe quel timestamp

Indique un timestamp à Fotovid et il capture cette image précise comme image hébergée — prête à intégrer directement comme aperçu de galerie, miniature de flux ou poster vidéo.

Obtenir ta clé API gratuite Lire la documentation →

curl -X POST https://api.fotovid.co/v1/video/extract-cover \
  -H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.yoursite.com/clip.mp4",
    "params": {
      "at": 3
    }
  }'

Pourquoi extraire une seule image est plus compliqué qu'il n'y paraît

Une miniature vidéo est en théorie triviale : se positionner à un timestamp, décoder une image, l'encoder en image fixe. En pratique, tu dois soit exécuter ffmpeg toi-même, soit t'appuyer sur une plateforme média surdimensionnée. Embarquer un binaire ffmpeg dépasse les limites de taille et de mémoire du serverless, les cold starts ralentissent, et décoder une source volumineuse peut dépasser le timeout d'une fonction. Et la plupart du temps, tu n'as pas besoin de toute la chaîne d'outils — juste d'une image.

Les binaires ffmpeg sont trop volumineux pour la plupart des bundles serverless et grèvent le budget de cold start
Décoder une grosse vidéo pour en extraire une seule image peut dépasser les limites de mémoire et de timeout de la fonction
Tu dois récupérer la source, lancer le traitement, puis héberger le résultat toi-même
Les plateformes média complètes embarquent des transformations, du stockage et un CDN dont tu n'as pas besoin juste pour obtenir un poster

Paramètres de la requête

POST /v1/video/extract-cover

Field	Type	Default	Description
source_url*	string (URL)	—	URL HTTPS de la vidéo source (lue via HTTP Range)
params.at	number	1	Nombre de secondes dans la vidéo pour capturer l'image

How it works

Ton premier appel en trois étapes

1
Obtiens une clé API gratuite
Inscris-toi et crée une clé. Tu authentifies chaque requête avec un header Authorization: Bearer p6_<key_id>:<secret>. Les nouvelles clés démarrent avec des crédits d'usage gratuits, pour que tu puisses mettre en place les miniatures avant de payer quoi que ce soit.
2
Appelle POST /v1/video/extract-cover
Envoie une enveloppe JSON avec source_url pointant vers l'URL HTTPS de ta vidéo, plus un objet params dans lequel tu précises le timestamp à capturer (sous forme de chaîne HH:MM:SS.mmm ou en secondes). Fotovid récupère la source, décode l'image à ce point précis, et l'encode en image sur notre infrastructure — aucun ffmpeg dans ta stack.
3
Utilise l'URL de l'image hébergée renvoyée
La réponse est un JSON plat avec id, type, et une url hébergée par fotovid pointant vers l'image extraite, accompagnée d'un expires_at. Affiche-la directement comme miniature ou poster, ou télécharge-la et stocke ta propre copie dans ton bucket pour garder le contrôle de sa durée de vie.

Questions fréquentes

Continuer d'explorer

Serverless ffmpeg — all guides Opération de filigranage Opération · Extraction audio ffmpeg sur AWS Lambda ffmpeg sur Vercel Tarifs

Déploie-le avec un seul appel API

Récupère une clé gratuite et fais ton premier appel en moins de cinq minutes.

Obtenir ta clé API gratuite