4oImageApi.io の画像保存は 14 日間。非同期生成はアーカイブまでを完了とする

4oImageApi.io をデザイン用バックエンドに組み込むチームは、タスク成功と素材の納品を分けて考える必要があります。taskId で状態を追跡し、14 日間の保存期間内に自分たちで管理するストレージへ結果を保存しましょう。コールバックは完了を通知できますが、ファイルのアーカイブに代わるものではありません。

ソース: docs.4oimageapi.io
2026年11月20日
4 min

デザイン用バックエンドを 4oImageApi.io に接続したら、生成完了の通知を受けた時点でタスクを閉じてよいのでしょうか。その画像を翌月のキャンペーンでも使うなら、答えは「いいえ」です。公式ドキュメントによると、生成画像の保存期間は 14 日間だけです。非同期生成なら「リクエストの送信」と「結果の取得」をバックエンドで分けて処理できますが、チーム自身が担うアーカイブの工程も必要です。

ここでは、社内の素材生成タスクをドキュメントに基づいて分析します。実際に API をテストしたものではありません。デザイナーがキャンペーン用の画像を依頼したと仮定すると、開発者が納品すべきものは、自社の素材ライブラリで再び開ける画像です。サーバー上でタスクが成功と表示されるだけでは足りません。

コールバックは完了を通知し、状態照会は結果の確認を助ける

ドキュメントには、タスク完了時に指定のコールバック URL へ POST 通知を送るとあります。詳細取得 API では taskId を使って生成状態、パラメーター、結果を照会できます。組み込み時には、自分たちのタスク記録で画像の依頼と taskId をひも付け、後から照会した際に元の依頼をたどれるようにします。

画面でも「生成中」と「デザイナーが確認できる状態」を区別すべきです。公式には GENERATING、SUCCESS、CREATE_TASK_FAILED、GENERATE_FAILED などの状態が示されています。通知を受けたら状態と結果を確認し、そのうえで待機を続けるか、失敗に対処するか、画像の確認へ進むかを決めます。どの通知も、使える素材が手に入った証拠だと考えてはいけません。

ポーリングを使う場合、ドキュメント上の上限は 1 タスクにつき毎秒 3 回の照会です。これは照会の上限であって、推奨頻度でも毎秒 3 枚を生成できるという約束でもありません。待ち時間の体験に合わせて照会間隔を設定し、タスクが最終状態に達したら繰り返しの照会を止めます。状態監視と画像生成の処理量を混同しないことが大切です。

14 日間の保存期間が、アーカイブを組み込みの一部にする

翌月に使う画像について、提供元の結果 URL を表に記録するだけでは十分に確実な運用とはいえません。画像は 14 日後に失効するため、その期間内に選んだ結果を自分たちで管理するストレージへ保存し、社内の素材の保存先をタスク記録へ書き戻すべきです。このアーカイブ処理は、組み込み側が実装する責任を負います。「コールバック対応」だからといって、製品が永久保存を代行してくれるわけではありません。

同じ依頼を軸に受け入れ確認を行えます。結果が開けること、画像がデザイン要件を満たすこと、社内のコピーを独立して読み出せることを確認してから、納品済みにします。生成は成功してもアーカイブに失敗した場合は、別々の状態として残し、後から保存をやり直せるようにします。デザイナーに素材がすでに登録済みだと誤解させないためです。これは受け入れ確認の設計案であり、実際の動作はここでは検証していません。

一時的なプレビューだけが必要な社内実験なら、チームは短期間の結果を受け入れられます。ただし、その場合も利用者に保存期間の制約を伝える必要があります。素材を長期的に再利用するなら、組み込みを拡大する前に保存先と失敗時の対応責任を決めましょう。4oImageApi.io の非同期機能は、待機と通知を分けて処理する方法を提供します。一方、チームの納品基準は、自分たちが継続して取り出せるファイルに置くべきです。

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

元の出典:docs.4oimageapi.io