動画アップロードを準備
prepare_video_uploadの引数、結果スキーマ、OAuth権限、安全注釈を確認済みMCP契約から生成した参考資料です。
このページの目次
ツール
prepare_video_upload
最大100 MiB、30秒の非公開MP4/MOV/WebMアップロードを準備します。バイト転送後に完了してください。深度処理や生成は開始しません。
権限と安全
OAuth権限:files:write
| 安全シグナル | 値 |
|---|---|
destructiveHint |
false |
idempotentHint |
false |
openWorldHint |
true |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | temporary_upload_created |
注釈は安全上の特性であり、利用者の同意、OAuth認可、サーバー検査の代わりではありません。
入力引数
| フィールド | 型 | 必須 | 既定値 | 制約 | 説明 |
|---|---|---|---|---|---|
request |
VideoUploadRequest | はい | — | — | — |
引数の例
{
"request": {
"byte_size": 1024,
"filename": "motion.mp4",
"mime_type": "video/mp4"
}
}
構造化された結果
| フィールド | 型 | 必須 | 既定値 | 制約 | 説明 |
|---|---|---|---|---|---|
expires_at |
string |
はい | — | format: date-time |
Upload session expiry in UTC. |
headers |
object |
はい | — | — | Use these exact headers for byte transfer. |
max_bytes |
integer |
はい | — | — | Source byte limit. |
method |
string |
いいえ | "PUT" |
const: "PUT" |
— |
upload_id |
string |
はい | — | format: uuid |
Session to complete after transferring bytes; not usable as a video input yet. |
upload_url |
string |
はい | — | — | Sensitive short-lived upload URL. Transfer bytes without API/OAuth credentials. |
エラーと次の対応
ツールエラーのerrorにはcode、message、retryable、request_id、detailsがあります。メッセージ本文に依存した分岐や私的入力の漏えいを避けてください。終状態の失敗でも部分成果物を調べます。署名付きURLは保存済みファイルではありません。
この記事は役に立ちましたか?
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー