Production engines

One frame of a shot as a PNG, drawn in the game's light (queued).

Renders a shot (a camera through the engine's world: forms from the sculptor, people and animals from the rig, open country, primitives, under the game's own sky, sun, shadow and haze) at t seconds as shot.png. width and height (both or neither) set the size, else the shot's own; at most 1920 by 1080 either way up. Costs 3 units plus 1 for each 1.6 megapixels: 4 at 1280x720, 5 at 1920x1080. A shot can draw a world of ours, named by id and never by a path (copperside and low-quarter): a zone subject {"kind": "zone", "world": "copperside", "zone": "city", "cut": [x, z, radius], "crowd": false} draws a street (copperside's start zone is city), and a terrain subject with the same world key draws its country. A street draws its crowd by default, which is most of its price: a still in a world costs 5 units more, one that draws the crowd 26.2 more again. It runs as a queued job: the answer is 202 with a job id at once, and GET /api/agents/jobs/<job> (or the MCP tool job) says when it is done and signs its files. A queued call is refused on the free plan with 402: its units buy only calls that answer at once, and queued jobs need a paid plan (a pass or the card plan).

post/api/agents/run/raster_render

Request

  • Base URL: https://tomorrowlives.com
  • URL: https://tomorrowlives.com/api/agents/run/raster_render
  • Auth: HTTP bearer

Request body

shotobject required

A shot document written inline: a camera, the sun and air, and subjects. raster_schema lists every key.

tnumber

The moment to draw, in seconds from the shot's start, for a shot with motion.

widthinteger

Output width in pixels, 16 to 1920; overrides the shot's own.

heightinteger

Output height in pixels, 16 to 1920; overrides the shot's own.

Response

Queued: the job id, its price and where to poll. Poll GET /api/agents/jobs/{job} until it is ok, refused or failed.

jobstring
verbstring
status'queued'
unitsinteger
created_atstring date-time
retry_after_sinteger

When to ask first, in seconds; also the Retry-After header

estimateunknown

Changes

No recorded changes to this operation across all 1 revision of this API.