元動画をプレビュー
preview_videoの引数、結果スキーマ、OAuth権限、安全注釈を確認済みMCP契約から生成した参考資料です。
このページの目次
ツール
preview_video
最大12時刻のラベル付きコンタクトシートと実際の元動画時刻を返します。AIやクレジットは使いませんが容量とメディア予算の制約があります。返るのはインライン画像ではなく署名付き画像URLで、認証情報を付けず取得します。最終Alpha品質は確認できません。
権限と安全
OAuth権限：assets:read
| 安全シグナル | 値 |
|---|---|
destructiveHint |
false |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | preview_asset_cached, signed_url_issued |
注釈は安全上の特性であり、利用者の同意、OAuth認可、サーバー検査の代わりではありません。
入力引数
| フィールド | 型 | 必須 | 既定値 | 制約 | 説明 |
|---|---|---|---|---|---|
asset_id |
string |
はい | — | format: uuid |
— |
request |
VideoPreviewRequest | はい | — | — | — |
引数の例
{
"asset_id": "00000000-0000-4000-8000-000000000003",
"request": {
"max_frame_size": 256,
"timestamps_seconds": [
0,
1,
2
]
}
}
構造化された結果
| フィールド | 型 | 必須 | 既定値 | 制約 | 説明 |
|---|---|---|---|---|---|
cells |
array<PreviewCell> | はい | — | — | Thumbnails in request order, preserving duplicates. |
height |
integer |
はい | — | — | Contact sheet height in pixels, including labels and padding. |
image |
AssetResponse | はい | — | — | Cached PNG contact sheet with a refreshable signed download URL. |
object |
string |
いいえ | "video_preview" |
const: "video_preview" |
— |
source_video_asset_id |
string |
はい | — | format: uuid |
Stable source video asset ID. |
width |
integer |
はい | — | — | Contact sheet width in pixels, including labels and padding. |
エラーと次の対応
ツールエラーのerrorにはcode、message、retryable、request_id、detailsがあります。メッセージ本文に依存した分岐や私的入力の漏えいを避けてください。終状態の失敗でも部分成果物を調べます。署名付きURLは保存済みファイルではありません。
この記事は役に立ちましたか？
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー