# 一時ダウンロードリンクの期限前に AI 生成動画を保存するには？ > プロバイダー URL を資産の保存場所ではなく、短期間の転送資格情報として扱います。ジョブ完了後すぐにダウンロードをキューへ入れ、永続オブジェクトストレージへストリーム転送し、サイズ、形式、チェックサムを検証してから、制作ジョブを完了にする前に永久 URI を記録します。 # 一時ダウンロードリンクの期限前に AI 生成動画を保存するには？ 生成が完了しても、バイトが自分の管理する保存先に存在するまでは永続資産ではありません。多くの動画 API が返す署名付きまたは一時 URL は転送用で、長期再生用ではありません。URL だけを保存すると、承認済み動画が数時間または数日後に消える可能性があります。 生成完了時に開始する独立した取り込み手順を作ります。ダウンロードタスクを取得し、現在有効な URL を得て、一時オブジェクトへストリーム転送し、検証後に決定的な永久キーへ昇格します。その時点で制作ジョブを完了にします。 ## URL を資格情報として扱う 署名付き URL は追加の認証 header なしで一時アクセスを許す場合があり、機密情報です。アクセスが厳密に管理されない限り、分析、顧客向けログ、チケット、永久 DB フィールドへ露出しません。 代わりに次を保存します。 * プロバイダージョブ ID * 利用可能な出力 ID * URL の発行時刻と観測した期限 * ダウンロード試行記録 * 最終オブジェクトキー * 検証メタデータとチェックサム 明示的な期限があれば余裕を持って初回ダウンロードを予定します。公開されていなければ短命と見なし、直ちにキューへ入れます。 ## 生成と資産取り込みを分ける リモート生成完了と永続保存は別状態です。 | 状態 | 意味 | 次の処理 | |---|---|---| | `generating` | プロバイダーが生成中 | 照会または webhook 待ち | | `output_ready` | 出力が完成 | ダウンロードをキューへ | | `downloading` | worker が転送を所有 | 一時保存へ転送 | | `verifying` | バイト到着済み | 検査とチェックサム | | `stored` | 永続オブジェクト確認済み | 永久 URI を保存 | | `complete` | 資産とメタデータを確定 | 納品 | | `download_retry` | 一時転送障害 | URL を更新して再試行 | | `needs_attention` | 自動復旧不能 | 証拠付きでエスカレーション | `output_ready` で完了にしないでください。この近道が期限切れ URL への参照を生みます。 ## ダウンロード前に webhook へ応答する webhook ハンドラーはイベントを検証、保存し、出力をキューへ入れて早く応答します。大容量動画を webhook 内で取得するとタイムアウトと再配信を招きます。 イベント ID またはジョブ ID と出力 ID の組み合わせで重複排除します。 ```text download_key = provider + provider_job_id + output_id ``` 重複 webhook は同じタスクへ収束します。照会と webhook は同じ `ensure_download_task` を呼べます。 ## 一時オブジェクトへストリーム転送する 応答全体をメモリへ読み込まず、チェックサム計算と同時に一時ファイルまたはマルチパートへ転送します。 1. 有効期限付きリースでタスクを取得する。 2. 対応時は新しい URL を取得する。 3. 接続と読み取りの上限時間を設定する。 4. 予期しないホストへのリダイレクトを拒否する。 5. バイト数と SHA-256 を計算しながら転送する。 6. 一時オブジェクトを終了する。 7. メディアを検証する。 8. 最終キーへ昇格またはコピーする。 9. URI とメタデータを確定する。 バックプレッシャーを使い、保存先より速くバッファしません。同時実行数はジョブ数だけでなく帯域、サイズ、ストレージ能力で制限します。 ## header だけでなく実際のバイトを検証する HTTP `200` でも HTML、JSON、切れたファイルの場合があります。`Content-Type: video/mp4` は証拠ですが、保証ではありません。 | 検証 | 検出する失敗 | |---|---| | 0 より大きいバイト数 | 空応答 | | 妥当な長さ | 途中で切れた転送 | | ファイル署名 | HTML や JSON の誤保存 | | コンテナ解析 | 壊れた構造 | | 0 より長い再生時間 | 不完全動画 | | 寸法とコーデック | 納品要件外 | | SHA-256 | 変更または重複バイト | | 必要時のデコード試験 | 解析できるが再生不能 | 観測メタデータを保存し、適切な許容差で要求した長さと解像度を比較します。厳密な要件がない限り数フレーム差で有効な動画を拒否しません。 ## 決定的な永続キーを使う 予測可能なキーで再試行を冪等にし、資産を追跡可能にします。 ```text videos/{account}/{operation_id}/{attempt_id}/{output_id}-{sha256_prefix}.mp4 ``` まず一時名前空間へ書きます。検証後に昇格するか、検証済みキーへの DB 参照を確定します。別 worker が同じチェックサムを保存済みなら再利用します。 サニタイズしていないユーザー提供名をパスへ入れません。元の表示名はメタデータとして保存します。 ## 失効と中断から復旧する 再試行の目的が明確になるようエラーを分類します。 * 接続リセットと一時ストレージ障害は通常再試行できる * 認証または失効応答は新しい URL が必要 * Not Found はプロバイダー削除の可能性 * チェックサムや検証の反復失敗は自動停止 * ローカル容量や権限は運用対応が必要 リモート ID を保持します。多くの API は完了済みジョブへ新しい署名 URL を出せますが、現在のエンドポイントで確認してください。 部分再開は送信元と保存先が検証済み Range に対応し、オブジェクト ID が変わらない場合だけ行います。それ以外は新しい一時オブジェクトへ最初から取得します。 ## 有効期限を考慮した再試行を選ぶ 通常の指数バックオフは URL の残り寿命を超える可能性があります。 ```text next_delay = min(exponential_backoff, time_until_expiry - safety_margin) ``` 期限が近ければ再試行前に更新します。ジッターを加え、一斉再接続を避けます。転送試行と URL 更新試行は別に上限を設けます。 ## 保存経路を保護する 既定で非公開 bucket を使い、必要に応じて暗号化、最小権限 worker 資格情報、閲覧用の短期 URL を使います。 署名を含む可能性があるため、元 URL のクエリ文字列をメタデータへコピーしません。ログでは削除するか、ホスト、パスハッシュ、発行時刻、期限だけを残します。 必要ならマルウェア検査やモデレーションを行います。キーと認可にテナント境界を設け、パス名だけに依存しません。 ## 保持と派生物のポリシーを作る 永続は永久ではありません。 | 資産クラス | ポリシーの考慮事項 | |---|---| | 承認済みマスター | 顧客契約と再生成費用 | | 納品派生物 | マスターから再作成可能 | | 拒否された生成 | 短い監査または異議期間 | | 一時アップロード | 検証後に自動削除 | | レビュープロキシ | 承認まで保持 | 削除状態と理由を記録します。再現性が必要ならプロンプト、ソースハッシュ、モデル、パラメータ、権利を保存します。ただし非決定的生成で同じバイトを再現できるとは限りません。 ## 永続化までの時間を監視する プロバイダー完了から検証済み保存までの時間を測ります。一時リンクが唯一のコピーであるリスク期間です。 次を監視します。 * ダウンロード待ち出力 * 最古の output-ready の経過時間 * 完了から保存までのパーセンタイル * URL 失効応答 * 転送再試行と URL 更新 * チェックサムまたは検証失敗 * ダウンロードおよび保存バイト数 * 永続 URI なしで完了したジョブ 最後の値は常に 0 にします。滞留時間が最短の観測 URL 寿命へ近づく前に警告します。 ## モデルアクセスと保存責任を明確にする [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=save-ai-videos-before-download-links-expire) はテキスト、画像、動画モデルへアクセスする OpenAI 互換プラットフォームを提供できます。統一プラットフォームはメタデータと請求を簡素化しますが、要件を満たす保存先へのコピーはアプリ側の責任です。 正確なモデルエンドポイントの出力と更新挙動を確認します。期限を作り上げたり、全モデルが同じ仕組みだと仮定したりせず、設定と能力チェックで差を扱います。 ## まとめ 一時 URL を期限付き転送資格情報として扱います。生成完了後すぐにダウンロードをキューへ入れ、一時オブジェクトへ転送し、実際のメディアを検証して永続キーへ昇格します。永久 URI とチェックサムを記録してからジョブを完了し、URL が失効しても唯一のコピーを失わない更新、再試行、保持、監視を設計します。 ## FAQ ### プロバイダーのダウンロード URL を最終動画の場所として保存できますか？ いいえ。署名付きまたは一時 URL は失効、無効化、変更される可能性があります。永続オブジェクトキーとジョブ ID を保存し、必要時だけ新しい転送 URL を取得します。 ### worker は動画全体をメモリへ読み込むべきですか？ 通常は不要です。大きなファイルでメモリを枯渇させないよう、チェックサムを計算しながら一時ファイルまたはマルチパートアップロードへストリーム転送します。 ### 保存済みにする前に何を検証しますか？ HTTP 応答、利用可能な場合の長さ、ファイル署名、想定コンテナ、ゼロより長い再生時間、寸法またはコーデック要件、チェックサム、永続書き込み成功を確認します。 ### ダウンロード中に URL が失効したらどうしますか？ 制作ジョブとリモート ID を保持し、不完全オブジェクトを破棄または隔離します。対応していれば新しい URL を要求し、検証済みの Range 対応に基づき再開または再取得します。 ### 元の生成動画をどれくらい保持しますか？ 顧客要件、法務とプライバシー、再生成費用、保存予算に基づきます。プロバイダー URL への偶然の依存ではなくライフサイクルポリシーを使います。 ### webhook 内で動画を直接ダウンロードできますか？ webhook は早く応答してダウンロードをキューへ入れます。別 worker が安全な再試行と検証を行えば、長い転送によるイベント損失を防げます。