Appeler l’API fal.ai depuis n8n : le guide pratique

ParPhil MAJ

fal.ai est une plateforme qui permet d’exécuter des modèles d’IA (génération d’image, de vidéo, d’audio) via une simple API HTTP. Pas de GPU à gérer, pas de modèle à héberger : vous envoyez une requête, vous recevez le résultat. Voici comment l’appeler concrètement — avec l’exemple d’une génération image-to-video orchestrée dans n8n.

Prérequis

  • Un compte fal.ai et une clé API (générée dans votre dashboard).
  • De quoi stocker la clé en sécurité — variable d’environnement ou gestionnaire de secrets, jamais en dur dans le workflow.
  • Une instance n8n (ou tout client HTTP) pour orchestrer l’appel.

Préparer le payload (nœud Code n8n)

On construit d’abord le corps de la requête : le prompt, l’URL de l’image source et le ratio d’aspect.

return {
  json: {
    prompt: JSON.stringify($input.first().json.output.final_prompt),
    image_url: $('parameters').first().json.s3bucket,
    aspect_ratio: "9:16"
  }
}

Appeler le modèle

L’endpoint suit toujours le format https://fal.run/<owner>/<model>. Ici, le modèle image-to-video. Pensez à ajouter l’en-tête d’authentification Authorization: Key VOTRE_CLE.

POST https://fal.run/fal-ai/veo3/fast/image-to-video

{
  "prompt": {{ $json.prompt }},
  "image_url": "{{ $json.image_url }}",
  "aspect_ratio": "{{ $json.aspect_ratio }}"
}

Bonnes pratiques

  • Mode asynchrone — pour les rendus longs (vidéo), fal.ai propose une file d’attente avec webhook : vous êtes notifié quand le résultat est prêt, sans bloquer le workflow.
  • Centralisez la clé — si plusieurs projets appellent fal.ai, passez par une variable d’environnement ou un proxy interne plutôt que de dupliquer la clé partout.
  • Vérifiez le ratio — 9:16 pour du vertical (Reels/TikTok), 16:9 pour du paysage, 1:1 pour du carré.

FAQ

fal.ai est-il payant ?

Oui, à l’usage : vous payez par appel/seconde de calcul selon le modèle. C’est généralement bien moins cher que d’héberger un GPU soi-même pour un usage ponctuel.

Quels modèles peut-on appeler ?

Génération d’images (Flux…), de vidéos (Veo, Kling…), transcription, upscaling… Chaque modèle a son endpoint fal.run/<owner>/<model> et son schéma de paramètres documenté.

Peut-on l’utiliser sans coder ?

Oui : avec n8n, un simple nœud HTTP Request suffit à appeler fal.ai et à chaîner le résultat avec d’autres étapes.

Publications similaires