pipeline-de-rendu-remotion
Transforme la composition en un MP4 livré.
Déclencheurs
remotion-composition-buildersignaleready: true.- L'utilisateur dit "rends-le" / "livre-le" avec un job connu.
Entrées
jobIdcomposition— identifiant correspondant àsrc/Root.tsx(par ex.Explainer)outputPath— relatif àremotion-studio/output/props— toutes les props d'entrée (marque + storyboard + ...) au format JSONlinear—{teamId, projectId}pour le routage du ticket
Méthode
- Vérification de type pré-rendu —
cd remotion-studio && npx tsc --noEmit. En cas d'échec, retourner àremotion-composition-builderavec l'erreur. - Synthèse vocale —
render/voiceover.tsécrit des MP3 par scène danspublic/audio/{jobId}/scene-N.mp3(souspublic/pour questaticFile()les résolve). Utilise une clé de cachesha1(voiceId|style|text). Ignoré siELEVENLABS_API_KEYest manquant — la composition doit tout de même être rendue avec uniquement du texte à l'écran. - Rendu —
npx tsx render/render.ts --comp={composition} --out={outputPath} --props='{...}' --jobId={jobId}. Enveloppé dans un timeout de 600s ; une tentative de reprise en cas de blocage/crash. - Validation — le fichier existe, durée ±0.5s de l'attendue, codec
h264, résolution correspond à la composition, taille <100 Mo. - Livraison :
- Téléchargement vers le bucket Supabase
remotion-renders— URL signée, conservation de 90 jours. - Telegram via
app.server.telegram_video.send_telegram_video()(l'utilitaire partagé). Si le fichier >45 Mo, envoyer le lien de l'URL signée au lieu d'un téléversement en ligne (la limite Telegram est de 50 Mo). - Ouvrir un ticket Linear dans
{teamId}/{projectId}avec : URL du rendu, résumé de la source, version de BrandConfig (sha git desrc/brands/{slug}.ts), chemin du fichier de composition.
- Téléchargement vers le bucket Supabase
- Statut — écrire un résumé dans
.research/renders/{jobId}.json.
Sortie
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"mp4Path": "remotion-studio/output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
"supabaseUrl": "https://<project>.supabase.co/storage/v1/object/sign/remotion-renders/...",
"telegramSent": true,
"linearIssue": "RA-2049",
"validation": { "durationSec": 60.0, "codec": "h264", "resolution": "1920x1080", "sizeMB": 12.4 }
}
Limites
- Ne jamais lancer le rendu avec
tsc --noEmiten échec — cela gaspille 2 à 5 minutes pour une sortie garantie mauvaise. - Ne jamais fusionner automatiquement la PR source (modifications de la composition + de la marque) avant que la vérification du rendu ne soit réussie.
- Ne jamais télécharger de rendus avec
[DRAFT]intégré dans le bucket de la marque — les brouillons vont dansremotion-drafts.
Escalade des échecs
- Timeout / blocage → tuer, réessayer une fois → si deuxième échec, ouvrir Linear avec
priority: 2, joindre stderr. - Échec de validation (mauvaise durée / codec) → Linear
priority: 3avec la différence par rapport à l'attendu. - Échec Telegram → basculer sur
send_telegram_document()avec le.mp4en pièce jointe.
Réutilisé
render/render.tsrender/voiceover.tsapp/server/telegram_video.py(utilitaire partagé)config/harness/projects.jsonpour la résolution de l'équipe/projet Linear
Clés API par projet
Ce skill est invoqué depuis l'intérieur du projet appelant (Synthex, Pi-SEO, RestoreAssist, n'importe lequel). Chaque projet fournit ses propres clés via son propre .env / .env.local. Le skill ne lit jamais les clés de Pi-Dev-Ops.
Variables d'environnement requises ou averties au moment du rendu :
ELEVENLABS_API_KEY— synthèse vocale. Absente = rendu silencieux avec uniquement du texte à l'écran (avertissement journalisé, rendu continue).TELEGRAM_BOT_TOKEN,TELEGRAM_CHAT_ID— livraison Telegram. Absentes = étape Telegram ignorée (le MP4 reste sur le disque + Supabase si configuré).SUPABASE_URL,SUPABASE_SERVICE_ROLE_KEY— téléchargement par URL signée. Absentes = étape Supabase ignorée.LINEAR_API_KEY— création de ticket. Absente = étape Linear ignorée.REMOTION_LICENSE_KEY— requis pour tout rendu commercial sous la licence fair-source de Remotion.
Modèle d'invocation depuis un shell de projet :
cd ~/Pi-CEO/Synthex
source .env.local # clés du projet
cd ~/Pi-Dev-Ops/remotion-studio
npx tsx render/render.ts \
--comp=Explainer \
--out=$OLDPWD/.remotion-renders/synthex-launch.mp4 \
--jobId=synthex-launch-$(date +%s) \
--props='{"brand":"synthex","hookSec":8,"ctaSec":8,"storyboard":[...]}'
Ou invoquer via l'API d'orchestration Pi-Dev-Ops qui hérite de l'environnement du projet appelant au moment du démarrage de la session.
Convention de sortie : écrire le MP4 dans <projet-appelant>/.remotion-renders/ (gitignoré) par défaut — chaque projet conserve ses artefacts dans son propre arborescence. Surcharger avec --out=....