esyOS
Get an API key

Esy docs · API v1

AI marketing production,
through one API.

Brief in, approved assets out. Every image, video and post checked, costed and traceable.

Looking for something?

Try

You post a workflow and its intake. Esy answers at once: pending.

api.esy.com/v1/runsReplay
POST /v1/runs
curl -X POST https://api.esy.com/v1/runs \
  -H "Authorization: Bearer $ESY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "templateId": "generate-illustration",
    "intake": {
      "prompt": "a lighthouse at dusk, storm rolling in",
      "style": "flat",
      "aspectRatio": "4:3",
      "quality": "low",
      "categories": "landscapes"
    }
  }'
sending…
Generate Illustration

run-fb0677b2

—

“a lighthouse at dusk, storm rolling in”

  1. Render illustrationopenai · gpt-image-2.5-sunburst
  2. Classify assetanthropic · claude-haiku-4-5
  3. Text gateanthropic · claude-haiku-4-5
  4. artifact.createesy
Elapsed
0.0s
Spent
$0.0000
Cost state
estimated

A replay of run-fb0677b2 from the quickstart, sped up: its real requests and responses, its step times and costs, and the file it stored.

Read in order

Five chapters, from a first run to shipping.

3 calls to a finished file62 pages34 endpointsUpdated Oct 3

  1. 01
  2. 02
  3. 03
  4. 04
  5. 05

That’s the spine. The other pages are details of these, and one search away.

What changed

  1. Oct 3Clients and charactersplatform · Clients: the businesses a workspace works for. A client groups the projects that are its domains and carries the business: status (lead, active, paused, past), billing terms in integer cents, and contacts. A project with no client is one of your own brands. New Clients concept and API pages.
  2. Sep 17Collections: artifacts made of artifactsdocs · New concept page, Collections. A clip art pack or a story book is one named thing made of many artifacts; Esy owns that whole, its members keep their ids through every re-roll, and each piece of work lands on a member by id.
  3. Sep 15Film cuts: chosen takes joined into one videoplatform · A new in-house tool, esy/video-join, joins video clips into one MP4: each clip trimmed to the seconds you keep, fitted to one frame size and frame rate (letterboxed, never stretched), in the order given. It runs on the worker with its bundled ffmpeg, so there is no provider spend — the only cost is one storage write.
  4. Sep 13The docs, rewritten against the running APIdocs · The docs live at docs.esy.com again, as their own site. They had been part of esy.com/docs since June; every esy.com/docs address now redirects to the same path here.
  5. Sep 12Source policies: a subject picks the sources it may be researched fromplatform · Two new Library resources. /v1/sources holds one approved source per item — its domain derived from the URL, the edition that makes a quote checkable, and what it is good for. /v1/source-policies holds one subject’s standing decision: which of those sources, what the subject covers, and where it stops.
The whole changelog