確認日2026-11-10 · API版2026-11-09 · Markdownを読む
メディアのアップロードと保持
メディアのバイト列は、一時的なプライベートオブジェクトストレージに直接送られます。REST と MCP
はアップロード手順を返します。ツールの JSON 内でバイナリファイルの内容を受け取ることはありません。
ストレージはデプロイメントで設定されている必要があり、設定されていない場合、アップロードの作成は
provider_unavailable を返します。
アップロードのライフサイクル
- ファイル名、申告 MIME、バイト数を指定して
POST /api/v1/media/upload-intentsを呼び出します。 返されたassetIdとsessionIdを別々の識別子として保存します。 methodを確認します。presigned_putの場合は、返されたヘッダーを使ってファイル全体をuploadUrlにアップロードします。multipart_initiatedの場合は、partSizeBytesで分割し、 番号付きの各パートを返された URL にアップロードして、その ETag レシートを保持します。ストレージへのリクエストに AiVideoEditor のベアラーキーを追加しないでください。sessionId(マルチパートの場合は各partNumberとetagを含むmultipart.parts) を指定してPOST /api/v1/media/{assetId}/finalizeで確定します。- 確定済みのアセット 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 の場合があります。
元のファイルは保管してください。メディアの有効期限が切れているか削除中の場合は、公開前に再アップロードしてください。