Pourquoi je ne peux pas simplement embarquer ffmpeg dans une Netlify Function ?

Les Netlify Functions tournent sur AWS Lambda, qui plafonne les déploiements à environ 50 MB zippés et 250 MB dézippés. Un binaire ffmpeg complet avec ses codecs ne rentre pas, donc le déploiement échoue ou le binaire ne part jamais. Fotovid déplace le travail vers un appel API, donc rien de ffmpeg ne vit dans ton bundle.

Et le timeout de la fonction ?

Par défaut, les Netlify Functions ont un timeout de 10 s, et même les fonctions en arrière-plan ne montent qu'à 26 s — généralement trop court pour un vrai transcodage. Comme Fotovid traite le média sur sa propre infrastructure, ta fonction n'a qu'à envoyer une requête HTTPS et attendre sa réponse, pas à exécuter ffmpeg jusqu'au bout.

Qu'est-ce que je récupère en retour de l'API ?

Une réponse JSON plate : id, type, url et expires_at (plus duration pour certaines opérations). L'url est un lien hébergé par Fotovid vers le fichier fini. Traite-la comme temporaire et conserve ta propre copie plutôt que de compter sur une durée de vie précise.

Quelles autres opérations sont disponibles en dehors du watermarking ?

En plus de POST /v1/video/watermark, Fotovid expose trim, extract-audio, extract-cover et probe pour la vidéo, ainsi que le watermark image et le trim audio. Chacune utilise la même enveloppe source_url + params, donc le pattern d'appel depuis ta Netlify Function est identique.

Comment fonctionne la tarification ?

Des credits à l'usage : $1 = 100 credits, et la plupart des opérations coûtent 1 credit. Tu démarres avec une clé gratuite, donc tu peux la brancher dans ta Netlify Function et confirmer que ça marche avant de dépenser quoi que ce soit.

Est-ce que Fotovid est une plateforme vidéo complète comme Cloudinary ?

Non — c'est volontairement découplé. Fotovid est un micro-service ffmpeg pensé pour les développeurs, facturé à l'opération, pour le serverless — pas une suite de gestion de médias. Tu appelles l'opération précise dont tu as besoin et tu reçois une URL de résultat hébergée, sans avoir à adopter toute une plateforme.

ffmpeg sur Netlify Functions

ffmpeg sur Netlify Functions : trop volumineux à embarquer, on l'héberge à ta place.

Les Netlify Functions tournent sur AWS Lambda, donc ffmpeg dépasse largement la limite de bundle et le timeout par défaut. Confie le travail à Fotovid : une requête envoyée, une URL de résultat prête en retour — largement sous n'importe quel timeout.

Obtenir ta clé API gratuite Lire la documentation →

// netlify/functions/watermark.mts
export default async (req: Request) => {
  const { videoUrl, logoUrl } = await req.json();

  const res = await fetch("https://api.fotovid.co/v1/video/watermark", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${Netlify.env.get("FOTOVID_API_KEY")}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      source_url: videoUrl,
      params: { type: "image", watermark_image_url: logoUrl, position: "bottom-right" },
    }),
  });

  const { url } = await res.json();
  return Response.json({ url });
};

Pourquoi ffmpeg échoue toujours sur Netlify

Les Netlify Functions s'exécutent sur AWS Lambda, et c'est précisément là que ffmpeg se heurte à des murs. Un binaire ffmpeg statique est bien trop volumineux pour la limite de bundle de ~50 MB zippés / 250 MB dézippés : le déploiement échoue, ou le binaire ne part tout simplement pas, sans avertissement. Même quand tu arrives à le faire rentrer, le timeout par défaut de 10 s de la fonction tue tout transcodage sérieux — les fonctions en arrière-plan t'offrent 26 s, ce qui reste insuffisant pour la plupart des traitements vidéo. C'est le piège classique du « ça marche sur ma machine, ça part en timeout en prod ».

Le binaire ffmpeg + ses libs dépassent la limite de bundle Lambda de 250 MB dézippés
Le timeout par défaut de 10 s (26 s en arrière-plan) coupe les vrais transcodages en plein milieu
Les cold starts et la gestion des layers ajoutent de la latence et des galères de packaging
Ce qui marche en local ne se reproduit pas dans la fonction déployée

Comment les équipes essaient de faire tourner ffmpeg sur Netlify

Avant Fotovid, c'étaient les options — et chacune est un travail dont tu te passerais bien.

Option	What it costs you	Verdict
Embarquer ffmpeg dans ta fonction Netlify	Dépasse le bundle de 250 MB et atteint le timeout de 10 s de la fonction
Héberger toi-même un conteneur ou une VM	Coût permanent, plus les correctifs, le scaling et le monitoring
Faire tourner une file de jobs + un worker	Nouvelle infra : une queue, des workers, des retries, la gestion des dead-letters
Transcoder dans le navigateur (WASM)	Lent, gourmand en mémoire, et plante sur mobile
Appeler l'API Fotovid	Une seule requête HTTPS ; rien à faire tourner, packager ou scaler

How it works

Ton premier appel en trois étapes

1
Récupère une clé API gratuite
Inscris-toi et crée une clé. Tu t'authentifies avec un header Authorization: Bearer p6_<key_id>:<secret> — pas de binaires, pas de layers Lambda, rien à embarquer dans ta Netlify Function.
2
POST ta vidéo vers l'endpoint watermark
Depuis ta Netlify Function, appelle POST /v1/video/watermark sur https://api.fotovid.co. Envoie l'enveloppe standard : un source_url pointant vers ta vidéo d'entrée, plus un objet params — définis type sur image, text ou combo, puis choisis une position comme bottom-right, plus opacity, scale et padding. Fotovid fait le travail ffmpeg en dehors de ta plateforme, donc ta fonction se contente d'une seule requête HTTPS rapide, plutôt que de devoir invoquer un binaire qu'elle ne peut de toute façon pas embarquer.
3
Utilise l'URL du résultat hébergé
La réponse est un JSON plat avec un id, un type, une url et un expires_at. L'url pointe vers la vidéo finie, hébergée par Fotovid. Renvoie-la à ton client ou conserve ta propre copie — les résultats étant hébergés temporairement, télécharge-les et re-stocke-les là où tu gères tes assets.

Questions fréquentes

Continuer d'explorer

Serverless ffmpeg — all guides ffmpeg sur Supabase Edge Functions ffmpeg sur Cloudflare Workers Opération · Extraction audio Opérations audio Docs

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