Pré-contrôle d'upload
Un rendu qui semble correct peut quand même être refusé ou retraité : mauvais format d'images par seconde pour une API, codec audio rejeté par un outil de publication, fichier trop volumineux, clip plus long que ce que l'application accepte. Ce skill exécute
https://github.com/viewgum/shortform-preflight sur le fichier, qui le lit avec ffprobe et le compare aux chiffres publiés par chaque application, puis transforme chaque échec en une commande FFmpeg.
Pas pour : l'emplacement du texte dans l'image (utilisez short-form-specs), ni ce que dit la vidéo.
Workflow
- Clarifier le périmètre uniquement si nécessaire. Par défaut : les quatre applications et les règles de téléchargement dans chaque application (
--route app). Pour le téléchargement web de TikTok, utilisez--route web. Si l'utilisateur publie via un planificateur ou son propre code, utilisez les règles de l'API de publication (--api), qui sont plus strictes pour Facebook Reels et Instagram. Pour TikTok Direct Post, transmettez la limite du compte (max_video_post_duration_secdepuis les informations créateur TikTok) comme--tiktok-endpoint direct --tiktok-max-seconds <n>; sans cela, indiquez que la durée n'est pas vérifiée. - Vérifier les outils :
ffprobe -version(FFmpeg),node -v(18 ou plus récent) etnpx --version. Le premier téléchargement du vérificateur depuis GitHub nécessite également un accès réseau. Si quelque chose manque, indiquez quoi, comment l'installer, et arrêtez. - L'exécuter, en JSON pour pouvoir lire chaque ligne :
npx -y github:viewgum/shortform-preflight <fichier> --json(ajoutez--api, ou--platform tiktok,youtube-shorts, selon les besoins). Code de sortie 0 signifie qu'aucune vérification n'a échoué ; 1 signifie qu'une vérification a échoué ou qu'une valeur requise n'a pas pu être lue (l'application apparaît comme incomplète ; indiquez quelle mesure manque) ; 2 signifie une entrée incorrecte. - Pour chaque échec et chaque avertissement que l'utilisateur risque de rencontrer, donnez la cause en une ligne, la source citée par la ligne, et une correction. Corrections courantes (ajustez les chemins et conservez le reste du fichier tel quel) :
- Fréquence d'images hors plage :
ffmpeg -i in.mp4 -r 30 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a copy -movflags +faststart -use_editlist 0 out.mp4 - Codec, chroma ou profil refusé :
ffmpeg -i in.mp4 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -movflags +faststart -use_editlist 0 out.mp4 - Atome moov à la fin, ou edit list (l'API Instagram refuse les deux) :
ffmpeg -i in.mp4 -c copy -movflags +faststart -use_editlist 0 out.mp4 - Fréquence d'échantillonnage audio, canaux ou débit binaire (l'API Facebook Reels liste 48 kHz stéréo, 128 kbps ou plus ; un encodeur réglé exactement à 128k moyenne souvent un peu en dessous) :
ffmpeg -i in.mp4 -c:v copy -c:a aac -b:a 192k -ar 48000 -ac 2 -movflags +faststart -use_editlist 0 out.mp4 - Trop long : coupez-le,
ffmpeg -i in.mp4 -t 89.9 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -movflags +faststart -use_editlist 0 out.mp4(réglez-tun peu en dessous de la limite : la coupe peut dépasser d'une image). - Plusieurs lignes à la fois : combinez les options en un seul ré-encodage plutôt que de chaîner des passes, comme dans l'exemple d'exécution.
- Chaque ré-encodage : ajoutez
-g 90à 30 ips (-g 72à 24) pour que les images clés arrivent toutes les 3 secondes ; l'API Facebook demande des groupes d'images fermés de 2 à 5 secondes, ce que le vérificateur ne peut pas tester. Vérifiez avecffprobe -v error -select_streams v -skip_frame nokey -show_entries frame=pts_time -of csv=p=0 out.mp4. - Trop volumineux : abaissez le réglage de qualité (un
-crfplus élevé) plutôt que la résolution. - Pas en 9:16 : padding ou recadrage à 1080 x 1920 uniquement si l'utilisateur le souhaite ; indiquez ce qui sera perdu.
- Fréquence d'images hors plage :
- Après une correction, exécutez à nouveau le vérificateur sur le nouveau fichier et montrez que la ligne passe maintenant.
Format de sortie
**Fichier :** demo.mp4 · 1080 x 1920 · 95 s · 23.976 ips · H.264 · AAC
**Règles :** API de publication
| Application | Résultat | Lignes en échec ou avertissement |
|---|---|---|
| Facebook Reels | échec | durée 95 s (l'API accepte 3 à 90 s) ; fréquence d'images 23.976 (nécessite 24 à 60) ; 44,1 kHz et mono (48 kHz stéréo listé, avertissement) |
| Instagram Reels | échec | edit list présente (aucune autorisée) ; atome moov après les médias (doit être au début) |
### Correction
Un seul ré-encodage pour toutes les lignes : `ffmpeg -i demo.mp4 -t 89.9 -r 30 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -ar 48000 -ac 2 -g 90 -movflags +faststart -use_editlist 0 fixed.mp4`
(sources : Meta for Developers, Reels Publishing API et IG User Media)
**Après la correction :** aucun échec.
- Citez les lignes du vérificateur lui-même ; ne récitez pas les limites de mémoire.
- Indiquez quelles règles ont été utilisées : téléchargement application, téléchargement web ou API de publication.
- Les lignes d'information (débits binaires recommandés, niveau sonore mesuré) ne sont pas des échecs ; mentionnez-les uniquement si l'utilisateur le demande.
Pièges courants
- Ne ré-encodez pas lorsqu'un remux suffit.
-c copyavec+faststartconserve la qualité. - Ne modifiez pas la résolution ou le rapport hauteur/largeur sauf demande de l'utilisateur ; demandez d'abord, car le recadrage perd de l'image.
- Ne traitez pas un avertissement comme un refus. Dites ce que l'application peut faire (retraiter, rejeter via l'API) uniquement comme la source l'indique.
- N'exécutez pas FFmpeg sur le fichier original. Écrivez toujours un nouveau fichier.
- Ne devinez pas une limite que le vérificateur signale comme non publiée. Dites que l'application ne la publie pas.