AiVideoEditor
無料で始める
メニュー

確認日2026-11-10 · API版2026-11-09 · Markdownを読む

メディアのアップロードと保持

メディアのバイト列は、一時的なプライベートオブジェクトストレージに直接送られます。REST と MCP はアップロード手順を返します。ツールの JSON 内でバイナリファイルの内容を受け取ることはありません。 ストレージはデプロイメントで設定されている必要があり、設定されていない場合、アップロードの作成は provider_unavailable を返します。

アップロードのライフサイクル

  1. ファイル名、申告 MIME、バイト数を指定して POST /api/v1/media/upload-intents を呼び出します。 返された assetId と sessionId を別々の識別子として保存します。
  2. method を確認します。presigned_put の場合は、返されたヘッダーを使ってファイル全体を uploadUrl にアップロードします。multipart_initiated の場合は、partSizeBytes で分割し、 番号付きの各パートを返された URL にアップロードして、その ETag レシートを保持します。ストレージへのリクエストに AiVideoEditor のベアラーキーを追加しないでください。
  3. sessionId (マルチパートの場合は各 partNumber と etag を含む multipart.parts) を指定して POST /api/v1/media/{assetId}/finalize で確定します。
  4. 確定済みのアセット ID を下書きの mediaIds で使用します。アップロードインテントだけでは アセットは公開可能になりません。

サーバーは不変の最終コピー上で実際のバイトとフォーマットを観察します。申告された サイズ/MIME は予約の入力であり、ファイルの有効性の証明ではありません。サポートされる基本 ファミリーは JPEG、PNG、MP4 です。個々の宛先がより厳しい制限を課す場合があります。 現在の最大ファイルサイズは 500 MiB (524,288,000 バイト) です。50 MiB 以上の ファイルはマルチパートを使用し、通常は 16 MiB のパートです。これらのデフォルトから導出するのではなく、 常に返されたサイズ、URL、有効期限に従ってください。

{
  "sessionId": "<session UUID from upload-intents>",
  "multipart": {
    "parts": [
      { "partNumber": 1, "etag": "<ETag returned by storage>" }
    ]
  }
}

これはマルチパートの形状の説明です。実際のすべてのパートを含めてください。単一 PUT による確定では sessionId のみを送信します。新しい API ミューテーションごとに独自の Idempotency-Key を与え、安全な同一リトライのために保持してください。

再開または放棄

有効期限が切れた署名付き URL は、恒久的なメディアのアドレスではありません。fromPart と toPart (最大 64 パートの両端を含む範囲) を指定して POST /media/{id}/upload-parts で新しいマルチパートの パート URL を要求してください。境界付きのリクエスト 形状は API リファレンス を参照してください。完了したパートを不必要に再アップロードしたり、マルチパートの 組み立てをストレージ経由で直接完了させたりしないでください。確定はサーバーが制御します。

不完全なアップロードをキャンセルする場合は POST /media/{id}/abandon を使用します。これにより、 共有クリーンアップワークフローを通じてその予約が解放されます。セッションの有効期限切れや消費済みの マルチパート状態では、新しいインテントが必要になる場合があります。ストレージのオブジェクトキーを推測しないでください。

一時的な保持

GET /media/{id} はステータスと動的な deleteAfter 情報を返します。恒久的な公開 URL ではありません。 予約済みおよび処理中の利用は、その作業の間メディアを保護します。 デフォルトのポリシーは、未使用の下書きメディアを 14 日間、確定済みのメディアを 72 時間、 失敗または曖昧な作業を関連する試行の後 7 日間保持します。実際の 保持は残っているすべての参照に依存します。deleteAfter は null の場合があります。 元のファイルは保管してください。メディアの有効期限が切れているか削除中の場合は、公開前に再アップロードしてください。