メディア系AIスキルの準備：FFmpegとImageMagickの導入ガイド
動画・音声を扱うFFmpegと、画像加工に役立つImageMagick。Windows・Macへの導入方法、動作確認、元ファイルを残す変換例を紹介します。スキルごとに必要なツールが異なる点も解説します。
AIスキルは作業の手順をエージェントに伝えるものです。動画や画像を実際に処理するために、別のプログラムが必要になる場合があります。今回は、動画・音声のFFmpegと、画像のImageMagickを紹介します。
「imageMagic」の正式な表記は ImageMagick です。どちらもコマンドから使えるため、AIエージェントに処理を依頼するときの道具になります。ただし、メディア系スキルすべてに両方が必要なわけではありません。
1. 何に使うプログラムなのか
- FFmpeg：動画や音声の形式変換、動画からの音声取り出し、音量の測定などに使います。同梱されることの多いffprobeは、長さやコーデックといったファイル情報の確認用です。
- ImageMagick：画像の縮小、形式変換、回転、切り抜きなどに使います。この記事ではImageMagick 7の
magickコマンドを使います。
公式の無料スキル 音声のラウドネスチェックはPythonとFFmpegが必要です。一方、画像の一括リサイズはPythonとPillowを使う構成で、ImageMagickは必須ではありません。ImageMagickは画像加工の別の選択肢です。まず商品ページの「必要な環境」を確認してください。
2. Windowsに導入する
PowerShellまたはWindows Terminalで、最初に既存のツールを確認します。すでに動く場合は重複して入れる必要はありません。
ffmpeg -version
ffprobe -version
magick -version未導入なら、Windows Package Manager（winget）が使える環境で次のコマンドを1行ずつ実行します。インストールする発行元や表示内容を確認し、管理者権限を求められた場合も内容を見てから判断してください。
winget install --id Gyan.FFmpeg --exact --source winget
winget install --id ImageMagick.Q16-HDRI --exact --source wingetGyan.FFmpegはGyanによるWindows向けビルドです。FFmpeg本体の公式ダウンロード案内にもGyanの配布先が掲載されています。wingetのパッケージIDは実際の検索で確認しましたが、この記事の検証では新規インストールは行っていません。
導入後はターミナルを閉じて開き直し、上の3つの確認コマンドをもう一度実行します。wingetがない場合は、FFmpeg公式の配布案内とImageMagick公式ダウンロードページから、自分のOS・CPUに合う方法を選んでください。広告経由の配布サイトや、出所の分からないインストーラーは使わないようにしましょう。
3. Macに導入する
Homebrewをすでに使っている場合は、ターミナルで次を実行します。
brew install ffmpeg imagemagick
ffmpeg -version
ffprobe -version
magick -versionHomebrewがない場合は、Homebrew公式サイトの導入手順と対応OSを先に確認してください。エラーを回避するためだけに sudo brew install を実行したり、不明なスクリプトを追加したりしないでください。Mac向けのコマンドはHomebrewの公式パッケージ案内を確認していますが、今回の実行テストはWindowsのみです。
4. 小さなファイルで動きを確かめる
コピーした素材を作業用フォルダーへ置いてから実行します。次のファイル名は見本なので、手元の名前に置き換えてください。音声のない動画など、入力によってはそのまま使えない例もあります。
動画から音声をWAVで取り出す例です。-n は同名の出力があると上書きせず停止する指定、-vn は映像を出力しない指定です。音声トラックのある input.mp4 を用意してください。
ffmpeg -n -i input.mp4 -vn -c:a pcm_s16le audio.wav動画の長さを秒で確認する例です。
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 input.mp4ImageMagickで縦横とも1600ピクセル以内に縮小し、WebPへ変換する例です。> は拡大を避ける指定です。シェルに記号を解釈させないため、サイズ指定を引用符で囲みます。
magick input.jpg -auto-orient -resize "1600x1600>" -strip -quality 82 output.webp
magick identify output.webp入力と出力は必ず別名にし、output.webp が存在しないことを事前に確認してください。ImageMagickは同名の出力を上書きする場合があります。-strip はメタデータやプロファイルも除去するため、色の見え方が変わる場合があります。色を厳密に扱う画像では、この指定を外すなど用途に合わせて調整し、出力を目で確認してください。
今回、WindowsのFFmpeg 7.1.1とImageMagick 7.1.1-47で、小さなテスト素材を作って上の処理を実行しました。動画の長さは1秒と取得でき、2400×1800の画像は1600×1200のWebPになりました。これは検証環境のバージョンであり、最新バージョンという意味ではありません。
5. 「コマンドが見つからない」とき
PATHは、ターミナルがプログラムを探す場所の一覧です。導入後も見つからない場合は、まずターミナルとAIエージェントのアプリを再起動します。実行ファイルがどこから選ばれているかは、次のコマンドで確認できます。
Windows：
Get-Command ffmpeg, ffprobe, magickMac：
command -v ffmpeg
command -v ffprobe
command -v magick複数のバージョンがある場合は、どれを使っているか確認しましょう。エージェントがクラウドやコンテナーで動いている場合、PCに入れただけではその環境から利用できません。実際に処理する環境側にも必要です。また、ImageMagick 7の手順では convert ではなく magick を使うと、Windowsの別コマンドとの取り違えを避けられます。
6. スキルと実行プログラムは分けて管理する
プログラムを導入したら、エージェントには「最初に利用可能なバージョンを確認し、元ファイルを上書きせず、少数のコピーで試してから処理してください」と伝えるのがおすすめです。
AI Skill Marketでは、出品ZIPに .exe を含めるとアップロードを拒否します。これはFFmpegなどを自分のPCへ導入してはいけないという意味ではありません。スキルのZIPに実行ファイルを同梱せず、必要な外部プログラムとして配布元と導入方法を案内してください。
新しいスキルを有効にする前には、公式の無料リスク点検スキルの利用も検討してください。静的な点検は安全を保証するものではなく、外部プログラム自体の安全性を認定するものでもありません。