「768P」は結局何ピクセルなのか — 生成動画のアスペクト比と端数の話

動画生成APIを製品に組み込むときの初期トラブル、「解像度表記の曖昧さ」について書いた記事です。「768P」と書いてあっても、それが16:9のときに横何ピクセルになるのか、アスペクト比を9:16に切り替えたら短辺が768のまま保たれるのか長辺が768になるのか、ドキュメントに書いていないことが多い、という話。これが見過ごされると、UIのサムネイル生成、CSSのaspect-ratio設定、CDNの変換設定に全部じわじわ効いてくる。問題の根は「業界標準を知らない」です。映像業界では480P、720P、1080Pという表記は短辺を指すのが慣習です。だから768Pは、アスペクト比16:9なら横は1365ピクセルになります。でもWebエンジニアがこれを知らずに実装すると、「APIが768Pを返した→正方形か横長か縦長か分からない→サムネイルのトリミング方向を間違える→顔がぶった切られた画像が世に出る」という流れになります。実は今、このタイプの詰まりが業界で増えています。生成系APIのベンダーは機能は高い。でもドキュメントはWeb標準じゃなくて映像業界の慣習で書いてあることが多い。動画編集ソフト出身のエンジニアとWebアプリ出身のエンジニアが同じドキュメントを読んでも、頭の中の規格が違う。だからすり合わせが必須です。中小企業の実装で増えているのは「高機能APIを導入した→正式ローンチ前に細部のズレが積み重なる」というパターンです。納期が来たから実装を始める、不明な仕様は勝手に決めて進める。でも後で「実は業界標準は違う」という発見が来ます。この記事が示唆しているのは、ドキュメントが不足しているAPIこそ、実装を始める前に必ず仕様を完全に確定させろ、ということ。業界慣習を知る人（この場合は動画編集経験者）を巻き込んで、「768Pは何ピクセルなのか、複数のアスペクト比で試して確認する」。その手間を惜しむと、ローンチ後に3倍返しで返ってきます。