アップロード事前チェック は何をしますか?
問題なく見えるレンダリングでも、APIが許容しないフレームレート、投稿ツールが拒否するオーディオコーデック、サイズ制限を超えたファイル、アプリが許容する長さを超えたクリップなど、拒否されたり再処理されたりすることがあります。このスキルは、GitHub上の https://github.com/viewgum/shortform-preflight をファイルに対して実行します。これは ffprobe でファイルを読み取り、各アプリが公開している数値と照合し、すべての失敗を1つのFFmpegコマンドに変換します。
対象外: フレーム内のテキストの位置(short-form-specsを使用)や、動画の内容。
ワークフロー
- 必要に応じてスコープを明確にします。デフォルト: 4つすべてのアプリ、および各アプリでのアップロードルール(
--route app)。TikTokのWebアップロードには--route webを使用します。ユーザーがスケジューラーや独自コードで投稿する場合は、公開APIルール(--api)を使用します。これはFacebook ReelsとInstagramでより厳しくなります。TikTokのDirect Postの場合は、アカウントの制限(TikTokのクリエイター情報からのmax_video_post_duration_sec)を--tiktok-endpoint direct --tiktok-max-seconds <n>として渡します。これがない場合は、長さが未確認であることを伝えます。 - ツールを確認します:
ffprobe -version(FFmpeg)、node -v(18以降)、npx --version。初回実行時はGitHubからチェッカーをダウンロードするため、ネットワークアクセスも必要です。不足しているものがあれば、どれかを伝え、インストール方法を説明し、中断します。 - 各行を読み取れるようにJSON形式で実行します:
npx -y github:viewgum/shortform-preflight <file> --json(必要に応じて--apiまたは--platform tiktok,youtube-shortsを追加)。 終了コード0はチェック失敗なし、1はチェック失敗または必要な数値が読み取れなかった(アプリが不完全と表示されます。どの測定値が不足しているかを伝えます)、2は不正な入力です。 - 各失敗について、およびユーザーが遭遇しそうな各警告について、原因を1行で、行が引用するソース、および1つの修正方法を示します。一般的な修正方法(パスを調整し、ファイルの残りの部分はそのままにします):
- フレームレートが範囲外:
ffmpeg -i in.mp4 -r 30 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a copy -movflags +faststart -use_editlist 0 out.mp4 - コーデック、クロマ、またはプロファイルが拒否された:
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 - Moovアトムが末尾にある、または編集リストがある(InstagramのAPIは両方を拒否):
ffmpeg -i in.mp4 -c copy -movflags +faststart -use_editlist 0 out.mp4 - オーディオのサンプルレート、チャンネル数、またはビットレート(Facebook Reels APIは48 kHzステレオ、128 kbps以上をリストしています。エンコーダーが正確に128kに設定されている場合、平均が少し下回ることがよくあります):
ffmpeg -i in.mp4 -c:v copy -c:a aac -b:a 192k -ar 48000 -ac 2 -movflags +faststart -use_editlist 0 out.mp4 - 長すぎる: カットします。
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(-tは制限より少し短めに設定します。カットは1フレーム長くなることがあります)。 - 複数の行が同時に発生する: パスを連鎖させるのではなく、例のように1回の再エンコードでオプションを組み合わせます。
- すべての再エンコードで: 30 fpsの場合は
-g 90(24の場合は-g 72)を追加して、キーフレームが3秒ごとに来るようにします。FacebookのAPIは2~5秒のクローズドGOPを要求しますが、チェッカーではテストできません。ffprobe -v error -select_streams v -skip_frame nokey -show_entries frame=pts_time -of csv=p=0 out.mp4で確認します。 - 大きすぎる: 解像度ではなく、品質設定(より高い
-crf)を下げます。 - 9:16ではない: ユーザーが望む場合にのみ、1080 x 1920にパディングまたはクロップします。失われるものを伝えます。
- フレームレートが範囲外:
- 修正後、新しいファイルで再度チェッカーを実行し、その行が合格することを示します。
出力形式
**ファイル:** demo.mp4 · 1080 x 1920 · 95 s · 23.976 fps · H.264 · AAC
**ルール:** 公開API
| アプリ | 結果 | 失敗または警告の行 |
|---|---|---|
| Facebook Reels | 失敗 | 長さ95秒(APIは3~90秒まで); フレームレート23.976(24~60が必要); 44.1 kHzモノラル(48 kHzステレオがリストされている、警告) |
| Instagram Reels | 失敗 | 編集リストあり(許可なし); Moovアトムがメディアの後(先頭にある必要あり) |
### 修正
すべての行のための1回の再エンコード: `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`
(ソース: Meta for Developers、Reels Publishing API、IG User Media)
**修正後:** 失敗なし。
- チェッカー自身の行を引用します。制限を記憶から言い直さないでください。
- 使用されたルール(アプリアップロード、Webアップロード、公開API)を伝えます。
- 情報行(推奨ビットレート、測定ラウドネスなど)は失敗ではありません。ユーザーが尋ねた場合のみ言及します。
よくある落とし穴
- リマックスで修正できる場合は再エンコードしないでください。
-c copyと+faststartで品質を保持します。 - ユーザーが尋ねない限り、解像度やアスペクト比を変更しないでください。まず尋ねます。クロッピングは画像を失うためです。
- 警告を拒否として扱わないでください。アプリが何をするか(再処理、API経由での拒否)は、ソースが述べているとおりにのみ伝えます。
- 元のファイルに対してFFmpegを実行しないでください。常に新しいファイルを作成します。
- チェッカーが非公開として報告する制限を推測しないでください。アプリが公開していないことを伝えます。