元動画の時刻をプレビュー

POST /assets/{asset_id}/previewの認証、フィールド、応答、エラー、安全な運用をソースから生成した参考資料です。

公開ベータAPI v1 · 1.4.0最終確認 2026-09-15

このページの目次

操作

POST /assets/{asset_id}/preview

operationId: preview_video_asset_v1_assets__asset_id__preview_post

AI処理やクレジット消費なしで、元動画の時刻ラベル付きコンタクトシートを作成または再利用します。キャッシュ画像は保存容量に計上され、通常の素材保持方針に従います。各セルには要求時刻と実際に表示した元フレームの時刻が入ります。署名付きURLの期限は別なので、素材検索で更新します。これは不透明な元動画のプレビューであり、最終Alpha品質ではありません。時刻は最大12個、各フレームの一辺は最大512 px。メディア予算はx-animgen-media-limitsにあります。

認証と副作用

サーバー側のBearer APIキーを使います。必要な権限：animations:read

有料生成は始めません。ほかの状態変更は上記を確認してください。

パラメータ

パラメータ	位置	型	必須	制約／既定値	説明
`asset_id`	`path`	`string`	はい	`format`: `uuid`	Owned public resource UUID; task, asset, and file IDs are not interchangeable.

リクエスト本文 (application/json)

本文必須：true

フィールド	型	必須	既定値	制約	説明
`max_frame_size`	`integer`	いいえ	`256`	`minimum`: `32`; `maximum`: `512`	Maximum thumbnail side in pixels, preserving aspect ratio.
`timestamps_seconds`	array<`number`>	はい	—	`minItems`: `1`; `maxItems`: `12`; 要素：`minimum`: `0`	Source timeline timestamps in request order, each strictly before the playable end. At most 12.

入れ子の全スキーマ：VideoPreviewRequest

リクエスト例

json

{
  "max_frame_size": 256,
  "timestamps_seconds": [
    0,
    1,
    2
  ]
}

応答

HTTP	本文	説明
`200`	VideoPreviewResponse	Successful public response. Example values are illustrative.
`400`	APIErrorEnvelope	Invalid input; correct the request before retrying.
`401`	APIErrorEnvelope	Missing, expired, or revoked API key.
`402`	APIErrorEnvelope	Insufficient credits; do not automatically purchase.
`403`	APIErrorEnvelope	Account eligibility, account status, or key scope does not allow this operation.
`404`	APIErrorEnvelope	Resource is unavailable, not owned, or its signature is invalid/expired.
`413`	APIErrorEnvelope	Request or decoded image exceeds the configured limit.
`415`	APIErrorEnvelope	Use supported image media types.
`422`	APIErrorEnvelope	Decoded image dimensions exceed the allowed size.
`429`	APIErrorEnvelope	Account-wide rate or queue limit; wait for Retry-After.
`500`	APIErrorEnvelope	Internal failure; preserve the task/key and retry only when marked retryable.
`503`	APIErrorEnvelope	Service/provider unavailable; retry only when error.retryable is true.

応答ヘッダー

HTTP	ヘッダー	型	説明
`429`	`Retry-After`	`integer`	Suggested wait in seconds; respect the server value and an overall deadline.
`503`	`Retry-After`	`integer`	Suggested wait in seconds; respect the server value and an overall deadline.

応答例

json

{
  "cells": [
    {
      "index": 0,
      "rect": {
        "height": 256,
        "width": 256,
        "x": 0,
        "y": 0
      },
      "requested_time_seconds": 0,
      "source_time_seconds": 0
    },
    {
      "index": 1,
      "rect": {
        "height": 256,
        "width": 256,
        "x": 256,
        "y": 0
      },
      "requested_time_seconds": 1,
      "source_time_seconds": 1
    },
    {
      "index": 2,
      "rect": {
        "height": 256,
        "width": 256,
        "x": 512,
        "y": 0
      },
      "requested_time_seconds": 2,
      "source_time_seconds": 2
    }
  ],
  "height": 280,
  "image": {
    "byte_size": 1024,
    "created_at": "2026-08-30T00:00:00Z",
    "download_expires_at": "2026-08-30T01:00:00Z",
    "download_url": "https://downloads.example.invalid/illustrative-asset",
    "format": "video_preview",
    "id": "00000000-0000-4000-8000-000000000006",
    "media": null,
    "mime_type": "image/png",
    "object": "asset"
  },
  "object": "video_preview",
  "source_video_asset_id": "00000000-0000-4000-8000-000000000003",
  "width": 768
}

この記事は役に立ちましたか？

ドキュメントの利用状況解析を許可

検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。プライバシーポリシー

お困りですか？サポートへ

ドキュメントを検索