API で Instagram リールを公開する
Instagram API は、公開 URL にある MOV または MP4 ファイルからリールを公開します。media_type を REELS にしてコンテナを作成し、Meta が動画を処理するまで待ってから公開します。リールは 3 秒から 15 分、最大 300 MB まで対応しています。Meta は、切り抜きや余白を避けるため 9:16 のフレームを推奨しています。
easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_instagram_post を使ってリールを公開します。
API で公開できる最長のリール。最短は 3 秒です。
リールファイルの最大サイズ。MOV または MP4 で、映像は H.264 か HEVC、音声は AAC です。
処理中のコンテナの状態を確認する、Meta が推奨する間隔。5 分を上限とします。
公開されずにリールのコンテナが待機できる時間。期限切れまでの期間です。
リールはどのように公開されますか?
3 つのステップで行います。まず、media_type を REELS、video_url に動画ファイルの場所を指定し、必要であればキャプションを付けて POST /<IG_ID>/media を送信します。Meta が動画を取得し、コンテナ ID を返します。次に、コンテナの status_code を確認しながら、Instagram が動画を処理し終えるまで待ちます。最後に、creation_id にコンテナ ID を指定して POST /<IG_ID>/media_publish を送信すると、レスポンスに新しいメディア ID が含まれます。
Meta の再開可能アップロード(コンピューターからファイルを送信できる方式)は、Facebook Login for Business(Unified Login を含む)をもとにした設定でのみ提供されています。Instagram Login を使う場合、動画は必ず公開 URL から取得されます。
動画の要件は何ですか?
Instagram が処理する前に、ファイルが満たす必要がある Meta のリール仕様です:
- ファイル形式:MOV または MP4(MPEG-4 Part 14)。エディットリストがなく、moov アトムはファイルの先頭にあること。
- 動画:H.264 または HEVC、プログレッシブスキャン、クローズド GOP、4:2:0 クロマサブサンプリング、毎秒 23 から 60 フレーム、幅は最大 1920 ピクセル、最大 25 Mbps。
- 音声:AAC、最大 48 kHz、モノラルまたはステレオ、128 kbps。
- アスペクト比:0.01:1 から 10:1 の範囲で任意。9:16 を推奨。
- 長さとサイズ:3 秒から 15 分、最大 300 MB。
動画の処理中には何が起きますか?
コンテナの status_code は、Instagram が動画を処理し終えるまで IN_PROGRESS と表示され、その後 FINISHED になります。公開できるのは FINISHED になってからです。それより前に公開すると、コード 9007、サブコード 2207027 で失敗します。これは修正ではなく、待つべきことを意味します。Meta は、状態の確認を 1 分ごとに、ただし 5 分を上限として行うことを推奨しています。
ERROR は、コンテナの処理が完了しなかったことを示し、EXPIRED は 24 時間公開されないまま放置されたことを示します。どちらの場合も新しいコンテナが必要です。PUBLISHED は、リールがすでに公開されていることを示します。
API でどのリールオプションを使えますか?
動画とキャプションのほかに、Meta のリールコンテナは次のパラメーターを受け付けます:
share_to_feed:true にするとリールをリールタブとフィードの両方に表示し、false にするとリールタブのみに表示します。どちらの値でも、リールタブへの掲載は保証されません。cover_url:リールタブのカバーとして使う、最大 8 MB の JPEG。中央の 9:16 部分に切り抜かれ、フィードに共有する場合は正方形に切り抜かれます。thumb_offset:カバーがない場合にサムネイルとして使うフレームの位置(ミリ秒)。0 が最初のフレームです。audio_name:リールの音声の名前。一度だけ設定できます。trial_params:トライアルリールを公開します。アカウントをフォローしていない人にのみ共有され、正式な公開に移行するまで続きます。
リールにはほかにどのような決まりがありますか?
リールは、コンテナが作成された時点から次のルールに従います。
- リールをカルーセルの一部にすることはできません。常に単独で公開されます。
- 公開時にアカウントのプライバシー設定が適用されます。リミックスを許可がオンなら、新しいリールもリミックスを許可します。
- 音楽タグ付けは、オリジナル音声の場合のみ利用できます。
- 後から読み取ると、リールは他の動画と同じく
media_typeVIDEO と表示されます。 - アカウントの 24 時間あたり 100 件の API 公開投稿の上限に、1 件として数えられます。
リールはどの指標を報告しますか?
メディアインサイトのエンドポイントを通じて、リールは reach、views、likes、comments、saved、shares、total_interactions、reposts を報告します。さらに独自の 3 つの指標、ig_reels_avg_watch_time、ig_reels_video_view_total_time、reels_skip_rate も報告します。reels_skip_rate は、最初の 3 秒以内にスキップされた視聴の割合です。likes、comments、views はオーガニックな活動のみを数えており、その元データは最大 48 時間遅れることがあります。
よくある間違い
- コンテナを作成した直後に公開すること。status_code が FINISHED になるまで待ってください。待たないと、サブコード 2207027 で呼び出しが失敗します。
- WebM や AVI のファイルを送信すること。リールは MOV または MP4 である必要があり、そうでなければ Meta はコード 352、サブコード 2207026 で拒否します。
- share_to_feed でリールがリールタブに表示されると期待すること。このパラメーターはフィードへの掲載を追加するだけで、リールタブに何を表示するかは Instagram が決めます。
- コンテナを公開しないまま一晩放置すること。コンテナは作成から 24 時間後に期限切れになり、その後は新しいコンテナが必要です。
動画 URL とキャプションを渡すと、動画の処理中でも自動的に公開まで完了します。リールは easyCoexistence の独自のキューからスケジュールすることもできます。接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
API でリールはどのくらいの長さにできますか?
3 秒から 15 分までで、最大 300 MB の MOV または MP4 ファイルです。
コンピューターからリールをアップロードできますか?
Instagram Login では、できません。API は公開 URL から動画を取得するので、まずファイルを公開リンクが得られる場所に置いてください。
API で公開したリールは、フィードにも表示されますか?
表示できます。share_to_feed パラメーターで、リールをリールタブに加えてフィードにも表示するかどうかを決められます。
リールの公開が 9007 で失敗するのはなぜですか?
Instagram がまだ動画を処理しているためです。status_code を確認し、FINISHED と表示されてから公開してください。リクエスト側で直す必要はありません。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日