get templates

The catalogue Explore shows: ready motion graphics, caption templates, camera moves, photo and video filters, the font catalogue, the graphics and caption templates saved in this workspace, and its timeline and canvas templates. id (as copied in Explore or returned by a listing) returns what it is and the exact call that uses it: a graphic with its controls and, with code, its source; a template with its holes and, for shelf templates, its pictures; ids reads several in one call. query searches, kind or shelf browses, and nothing returns the kinds and shelves. Read only. Free.

POST

/

tools

/

get_templates

get templates

curl --request POST \
  --url https://eversince.ai/api/v1/tools/get_templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "ids": [
    "<string>"
  ],
  "query": "<string>",
  "shelf": "<string>",
  "code": true
}
'

import requests

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

payload = {
    "id": "<string>",
    "ids": ["<string>"],
    "query": "<string>",
    "shelf": "<string>",
    "code": True
}
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({
    id: '<string>',
    ids: ['<string>'],
    query: '<string>',
    shelf: '<string>',
    code: true
  })
};

fetch('https://eversince.ai/api/v1/tools/get_templates', 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,
      "queued_minutes": 123,
      "left_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,
      "queued_minutes": 123,
      "left_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 key's own.

Body

application/json

id

string

The id the user copied in Explore, or one a listing returned.

ids

string[]

Several ids in one call: entries returns each in the order given, a miss reported beside its id. An answer stops at about 100,000 characters and names the rest in next_ids.

Required array length: 1 - 20 elements

query

string

Words for what is needed: "lower third with a photo". Returns the closest matches.

kind

enum<string>

One kind: graphic (alone it lists the shelves), caption, move (camera moves), timeline (video templates, ours then this workspace's), canvas (image templates, ours then this workspace's), filter, font (every family the renderer draws, with its weights and scripts).

Available options:

graphic,

caption,

move,

timeline,

canvas,

filter,

font

shelf

string

A graphics shelf by name, as a listing gives it: "Lower thirds". Lists its graphics.

code

boolean

With a graphic's id: include its source code.

Response

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

ok

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

get templates

curl --request POST \
  --url https://eversince.ai/api/v1/tools/get_templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "ids": [
    "<string>"
  ],
  "query": "<string>",
  "shelf": "<string>",
  "code": true
}
'

import requests

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

payload = {
    "id": "<string>",
    "ids": ["<string>"],
    "query": "<string>",
    "shelf": "<string>",
    "code": True
}
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({
    id: '<string>',
    ids: ['<string>'],
    query: '<string>',
    shelf: '<string>',
    code: true
  })
};

fetch('https://eversince.ai/api/v1/tools/get_templates', 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,
      "queued_minutes": 123,
      "left_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,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}