fal と Replicate:商品素材の一括生成は、どこまでできれば本当の納品になるのか

生成した画像や動画を自社の素材ライブラリに取り込むチーム向けに比較する。fal のキューとメディア保持制御は受け渡し期限の明確な管理に、Replicate のイベントフィルターは既存の予測タスクのパイプラインに向く。どちらもファイルを別途保存し、生成成功と業務上の受け入れを分ける必要がある。

ソース: fal.ai
2026年11月8日
9 min

マーケティング向けのプロダクトチームが商品画像や短い動画を一括生成する際、本当に必要なのは、検索、レビュー、公開ができる素材だ。fal と Replicate はどちらも API でホストされたモデルを呼び出せる。選定ではまず対象モデルが商品の表現要件を満たせるかを確認し、その後で生成終了後にファイルを自社システムへどう渡すかを比較すべきだ。

リクエストごとにメディアの保存期間を設定したいなら、fal を優先して評価する価値がある。予測タスクを軸に構築したシステムがあり、開始、出力、ログ、完了のイベントに応じて通知を受けたいなら、Replicate の方がその構造を引き継ぎやすい。ただし、どちらも一度の成功コールバックで素材の保存と業務上の受け入れ確認を代用することはできない。以下の判断は公式ドキュメントに基づき、アカウントでの実測や生成品質の順位を示すものではない。

「完了」と「利用可能」を先に区別する

fal のキュー投入 API は request_id と、状態、結果、キャンセルの URL を返す。状態が COMPLETED になった後も結果を取得する必要がある。結果 API はモデルのエラーをそのまま返すため、「キュー処理が終わった」ことは「生成に成功した」ことではない。Replicate は一回の呼び出しを prediction と呼び、状態を starting、processing、succeeded、failed、canceled、aborted に分ける。aborted は期限を過ぎても実行が始まっていないタスクを指す。

素材ライブラリでは、どちらの状態モデルも最終的に自社のレコードへ対応付ける必要がある。投入済み、生成成功、ファイル保存済み、レビュー待ち、承認済みといった状態だ。業務バッチ番号、商品番号、プラットフォームのタスク ID、モデル識別子、生成パラメーターを保存し、失敗時の再試行で別のバージョンを混同しないようにするとよい。これは納品フローの設計であり、いずれかのプラットフォームが自動提供する受け入れ機能ではない。

キャンセルの結果も記録する必要がある。fal は待機中のタスクを直接削除し、実行中のタスクにはキャンセル信号を送るが、停止方法はモデルアプリケーションが決める。CANCELLATION_REQUESTED を受け取っても、すでに停止したとはみなせない。Replicate は実行中の prediction をキャンセルする API を提供する。どちらを接続する場合も最終状態を引き続き確認し、取り消したバッチの遅れて届く結果が公開フローへ自動で入らないようにすべきだ。

コールバックは待ち時間を減らすが、補完確認は不要にならない

fal は非同期タスクが終了すると webhook を送信する。ドキュメントでは 2xx で受信確認を返すと定めている。ネットワークエラー、タイムアウト、4xx、5xx はバックオフ付きの再試行を引き起こし、最大 31 回だが、結果の保持期間にも制約される。通常は約 1 時間で、結果が 10 KB に達すると約 6 分となる。3xx リダイレクトでは再試行しない。ここでいう結果サイズは API の結果であり、生成動画のファイルサイズではない。

Replicate は webhook_events_filter で通知の種類を選べる。完了イベントは失敗やキャンセルを意味する場合もあるため、completed を見ただけでライブラリに登録してはいけない。公式の受信ガイドによると、終端状態のコールバックが失敗した場合はバックオフ付きで再試行し、最後の試行はタスク完了から約 1 分後となる。中間状態は再試行されず、通知が重複したり順不同になったりする可能性もある。処理途中の通知が必要な場合には柔軟だが、その分、状態を統合するロジックが増える。

どちらでも、まず署名を検証し、イベントを永続化して素早く受信確認を返し、ファイルのダウンロードはバックグラウンド処理に任せるとよい。通知を受け取れなかった結果を回収する補完確認タスクも別途用意する。fal は JWKS 公開鍵で ED25519 署名を検証し、Replicate はユーザーまたは組織に対応する署名キーと HMAC-SHA256 を使う。両者とも生のリクエストボディに対して検証し、タイムスタンプを確認する必要があり、再シリアライズした JSON で原文を置き換えてはいけない。それでもプラットフォームのタスク ID による冪等処理は必要で、重複登録を防がなければならない。

ファイルを先に自社ストレージへ保存する

fal のメディア保持ドキュメントは CDN ファイルとリクエスト記録を分けて扱う。生成ファイルは URL として返り、X-Fal-Object-Lifecycle-Preference で expiration_duration_seconds を設定でき、値が null なら期限なしとなる。リクエストごとの設定はアカウントのデフォルト設定に優先する。リクエストの入出力記録はデフォルトで 90 日保持されるが、メディアファイルが必ず 90 日間ダウンロード可能という意味ではない。期限切れのファイルは完全に削除されるため、チームは自社のダウンロード期限を明確にする必要がある。

Replicate の API prediction はデフォルトで 1 時間後に入力パラメーター、出力値、出力ファイル、ログを削除する。Web 上の実行データには別の保持ルールがあり、Web の履歴から API ファイルの寿命を推測してはいけない。クライアントの replicate.run() は FileOutput オブジェクトを返すことがあり、HTTP API のファイル出力は HTTPS URL を使う。オブジェクトでもリンクでも、継続利用にはコピーの保存が必要だ。

夜に短い動画を一括生成し、翌朝にレビューするとする。どちらでも生成後に自社ストレージへ自動ダウンロードし、永続的な URL をレビューページへ渡すべきだ。Replicate はデフォルトで 1 時間後に削除するため、人が作業を始めるまでこの手順を待てない。fal の設定可能な期限はより多くの制御を提供するが、明示的に設定してダウンロード完了を検証し、ベンダーのリンクを素材ライブラリの永久 URL として扱わないようにする必要がある。

保存後に合格した素材を基準に選ぶ

少量の代表的な商品要件を使って、接続の受け入れ確認を行える。正常完了、生成失敗、処理中のキャンセル、コールバックの重複、一時的なコールバック先への接続不能、ファイルのダウンロード失敗のいずれにも、追跡可能な結果があるべきだ。商品の見た目、文字、画面サイズ、動画の長さが要件を満たすかを確認し、レビューに合格したファイルだけを納品数に数える。このチェックリストは試用方法の提案であり、実施済みのテスト結果ではない。

対象モデルがどちらも要件を満たすなら、リクエストごとのメディア保存方針を重視するチームは fal の試験接続から始められる。複数種類の途中イベントを重視し、prediction のデータ構造がすでにあるチームは Replicate を先に試せる。自動ダウンロード、補完確認、レビュー記録がないままでは、どちらも無人の一括納品を直接任せる用途には適さない。予算も「生成と再試行の総費用に保存・処理費用を加え、レビュー合格素材数で割った値」で測るべきだ。同じモデル名だけでは、実行設定、品質、利用可能な素材一件当たりの費用が同じとは証明できない。

内容説明:本記事は公開情報をもとに整理した、ツール選定の参考情報です。機能、料金、関連ポリシーは随時変更される場合があります。最新の公式情報をご確認ください。

元の出典:fal.ai