Comment définir le début et la fin du clip ?

Passe start et end dans l'objet params. Chacun peut être un timestamp au format "00:01:30.500" ou un nombre de secondes comme 90.5. Le clip couvre l'intervalle semi-ouvert [start, end), donc la frame à end n'est pas incluse.

Le trim est-il précis à la frame ?

Oui. Fotovid re-encode la plage sélectionnée avec x264 plutôt que de copier jusqu'au keyframe le plus proche, donc le clip commence et se termine exactement où tu l'as demandé. Le compromis, c'est le re-encodage — et c'est exactement pour ça que c'est pénible à faire toi-même en serverless.

Dans quel format est le résultat ?

Le résultat est toujours un MP4 re-encodé avec x264, renvoyé sous forme d'URL hébergée par Fotovid dans le champ url de la réponse, avec la durée du clip.

Combien de temps l'URL du résultat reste-t-elle disponible ?

Chaque réponse inclut un timestamp expires_at. Considère l'URL hébergée comme temporaire et télécharge le clip pour en conserver ta propre copie, là où tu sers déjà tes fichiers.

Combien coûte un trim ?

Le trim est une opération facturée en credits, à raison d'un credit par appel. Les credits coûtent 1 $ pour 100, et chaque compte démarre avec des credits gratuits, donc tu peux construire et tester avant de payer quoi que ce soit.

Puis-je utiliser ça à la place de ffmpeg sur Vercel ou Lambda ?

C'est exactement le but. Fotovid est le microservice ffmpeg prêt à l'emploi pour le serverless — tu fais un seul appel HTTPS au lieu d'embarquer ffmpeg, donc plus aucun binaire, pénalité de cold start ou limite de mémoire à contourner.

Opération vidéo

Découpe ta vidéo en un clip précis à la frame, sans ffmpeg à embarquer.

Découpe ta vidéo en un clip qui se termine exactement sur la frame voulue — Fotovid gère les keyframes pour que les limites du clip restent nettes. Le microservice ffmpeg prêt à l'emploi te renvoie une URL MP4 hébergée.

Obtenir ta clé API gratuite Lire la documentation →

curl -X POST https://api.fotovid.co/v1/video/trim \
  -H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.yoursite.com/recording.mp4",
    "params": {
      "start": "00:00:05",
      "end": "00:00:20"
    }
  }'

Découper une vidéo en serverless : plus compliqué qu'il n'y paraît

Découper un clip a l'air de tenir en une seule commande ffmpeg, mais exécuter cette commande sur Vercel, Lambda ou Workers implique de livrer un binaire statique de plus de 70MB, de lutter contre les cold starts et les limites de mémoire, et de streamer l'entrée tout en hébergeant la sortie quelque part. Un trim précis à la frame impose un re-encodage, qui pousse le CPU et le temps d'exécution au-delà de ce que la plupart des fonctions serverless autorisent. Tu finis par maintenir une infrastructure qui n'a rien à voir avec ton produit.

Les binaires ffmpeg dépassent largement les limites de taille de bundle et de mémoire qu'impose le serverless
Un trim précis à la frame nécessite un re-encodage — un travail lent et gourmand en CPU sur lequel les fonctions serverless finissent en timeout
Tu dois quand même gérer le téléchargement de l'entrée et l'hébergement du clip obtenu
Utilise cet endpoint quand tu as besoin de clips highlights nets, d'extraits pour les réseaux sociaux ou de courts aperçus, sans avoir à gérer tout un pipeline média

Paramètres de la requête

POST /v1/video/trim

Field	Type	Default	Description
source_url*	string (URL)	—	URL HTTPS de la vidéo source
params.start*	string \| number	—	"HH:MM:SS(.mmm)" ou secondes (ex. 5.5)
params.end*	string \| number	—	Doit être supérieur à start ; tronqué à EOF

How it works

Ton premier appel en trois étapes

1
Récupère une clé API gratuite
Inscris-toi et crée une clé depuis le dashboard. Tu t'authentifies en envoyant un header Authorization: Bearer p6_<key_id>:<secret>. Chaque nouveau compte démarre avec des credits gratuits, et 1 $ donne 100 credits — un trim coûte un credit par appel.
2
Appelle POST /v1/video/trim
Envoie une requête à https://api.fotovid.co/v1/video/trim avec un body JSON contenant source_url (l'URL HTTPS de ta vidéo d'entrée) et un objet params avec start et end. Les deux acceptent soit un timestamp HH:MM:SS.mmm, soit un simple nombre de secondes ; le trim est précis à la frame sur l'intervalle semi-ouvert [start, end) et re-encodé en MP4 avec x264.
3
Utilise l'URL renvoyée pour ton clip
La réponse est un JSON plat avec id, type, une url hébergée par Fotovid pour le MP4 découpé, un expires_at et la durée du clip. Télécharge le fichier et conserve ta propre copie pour garder le contrôle sur son emplacement — puis sers-le, joins-le, ou transmets-le à l'étape suivante de ton workflow.

Questions fréquentes

Continuer d'explorer

Serverless ffmpeg — all guides Opérations audio Miniature vidéo / couverture ffmpeg sur Supabase Edge Functions ffmpeg sur AWS Lambda 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