Skip to main content
POST
Create video scenes
Extract scenes from a video using shot detection or time-based segmentation, with automatic frame sampling and descriptions.
  • Two extraction types: shot-based (detects camera cuts) and time-based (fixed intervals)
  • Shot-based default threshold is 20 (lower = more sensitive to changes)
  • Time-based allows specifying interval (in seconds) and frames per segment
  • Returns SceneCollection with Scene objects including frames and metadata
  • Extracted frames can be used for visual search and thumbnail generation

Authorizations

x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

video_id
string
required
Pattern: ^m-
Example:

"m-12345"

Body

application/json
scene_type
enum<string>
Available options:
shot,
time_based
Example:

"shot"

callback_url
string
Example:

"https://webhook.example.com/callback"

Response

200 - application/json

Scene creation started

success
boolean
Example:

true

status
enum<string>
Available options:
processing,
done,
failed
Example:

"processing"

data
object