inspect media

Look at media, or ask a model about it: a library item, or a picture or video at a web address (urls) read without keeping it. An image returns the picture with its size in pixels. A video returns frames: overview (one storyboard grid, frames spread evenly over the file, default), window (a grid of one span), frame (one moment), strip (one span as frames with the waveform and words under them), or shot_log (every segment in order with its span, frame, spoken lines and a written line each; cloud only, one video). A file with a transcript returns spoken, unasked: the sentences in the span, the opening lines for a whole file (transcribe_media reads the rest). cuts: true adds every shot change and shot length once the video is indexed. Audio returns spoken alone. prompt, on one video or audio file, has a model watch or listen and answer the question, with the moments the answer rests on as seconds; a long read returns a job; cloud only, not for images. Up to 12 refs or urls a call, in order, each item naming its pictures by position. Cached. inspect_timeline reads the composite. Free to look; cuts on an unindexed video, shot_log and prompt use cloud processing.

POST

tools

inspect_media

inspect media

curl --request POST \
  --url https://eversince.ai/api/v1/tools/inspect_media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://eversince.ai/api/v1/tools/inspect_media"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://eversince.ai/api/v1/tools/inspect_media', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key

string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id

string

The workspace this one call acts in, when it is not the default: for a key or a connected agent, one of the workspaces the user allowed it.

Body

application/json

ref

string

A library item ref. One of ref, refs or urls.

refs

string[]

Up to 12 library item refs, each read with the same mode, window and at. One that cannot be read comes back as { ref, error } beside the rest.

Required array length: 1 - 12 elements

urls

string<uri>[]

Up to 12 web addresses of pictures or videos, read without keeping them. The same modes as refs; twelve in all with refs. One that cannot be read comes back as { url, error }.

Required array length: 1 - 12 elements

mode

enum<string>

Video only. overview = whole-video storyboard grid (default); window = zoom into a span; frame = one exact moment; strip = one span (up to 60 s) as frames, waveform and words in one picture.

Available options:

overview,

window,

frame,

strip,

shot_log

window

object

window and strip modes: {start, end} in seconds.

Show child attributes

number

frame mode: timestamp in seconds.

Required range: x >= 0

tiles

integer

overview and window: how many frames the grid holds (default 36 up to a minute, else 12 or 16). Fewer draws each larger.

Required range: 1 <= x <= 36

grid

boolean

An image or a single video frame (frame mode) comes back ruled in tenths, 0 to 1 each way, so a point read off it is the x and y that edit_points on generate_image and generate_video take.

cuts

boolean

Video only: every shot change and shot length. Free once the video is indexed; otherwise the file is read through on cloud processing.

prompt

string

A question for a model to answer about one video or audio file: motion, sound, timing, how type enters, when a thing happens. Answered in the call, moments as seconds, or past about 20 seconds as a job_id for get_jobs; no answer, no charge. One ref or url.

Required string length: 1 - 4000

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

inspect media

curl --request POST \
  --url https://eversince.ai/api/v1/tools/inspect_media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://eversince.ai/api/v1/tools/inspect_media"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://eversince.ai/api/v1/tools/inspect_media', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Discovery

Timeline

Workspace

Library

Canvas

Generation

Research

Account

Models

Uploads

Webhooks

inspect media

Authorizations

Headers

Body

Response