extractMedia - VidJutsu

Usage

const { data, error } = await vj.extractMedia({
  mediaUrl: "https://cdn.example.com/video.mp4",
  frames: "auto",
  audio: true,
});

Parameters

Field	Type	Required	Description
`mediaUrl`	`string`	Yes	URL of the video to extract from
`frames`	`number[] \| "auto" \| "last"`	No	Frame indices (`[0, 75, 150]`), `"auto"` for 3 evenly spaced, or `"last"` for the final frame
`audio`	`boolean`	No	Extract audio track as WAV
`metadata`	`boolean`	No	Return video metadata. Defaults to `true`

Response

{
  "frames": [
    { "index": 0, "url": "https://cdn.vidjutsu.ai/..." },
    { "index": 75, "url": "https://cdn.vidjutsu.ai/..." },
    { "index": 150, "url": "https://cdn.vidjutsu.ai/..." }
  ],
  "audio": {
    "url": "https://cdn.vidjutsu.ai/...",
    "duration": 10.2
  },
  "metadata": {
    "width": 1080,
    "height": 1920,
    "fps": 30,
    "duration": 10.0
  }
}

Rate limit

Counts toward the daily extract limit (100/day). Resets at 00:00 UTC; exceeding it returns HTTP 429.