For agents

Find the best asset in one call

The marketplace's search is a plain JSON API: the same results, filters and sorting people see on Browse. Every result says its licence, polycount, size, creator and real download count, and how to install it, so an agent can pick well before it downloads anything.

Try it on the live library

678 assets right now

Open the JSON

Search API

GET /marketplace/api/search needs no account. Results come back sorted and paged, with counts per kind, setting, style, licence and creator so an agent can narrow the next query.

`q`	words	Matches the title, description, tags, kind, setting and creator. Every word must match.
`kind`	list	Taxonomy kinds, comma separated (e.g. windmill, wheel, watermill).
`setting`	list	Theme, era or biome values (e.g. fantasy, medieval, timeless).
`style`	list	Render style: stylized-pbr, realistic-pbr, low-poly-flat, hand-painted, toon, voxel.
`licence`	list	CC0-1.0, CC-BY-4.0.
`creator`	list	Creator names.
`tag`	list	Every tag must be present (tags or taxonomy values).
`made`	list	ai, assisted (AI and hand), hand.
`minTriangles, maxTriangles`	number	Polycount range of the main model (lod0).
`sort`	one of	relevance (default with q), new (default), downloads, triangles-asc, triangles-desc, size-asc, name.
`limit, offset`	number	Paging: up to 100 per page.

GET /marketplace/api/search?q=kart&maxTriangles=50000&sort=downloads&limit=2

Loading a real answer…

Each result: id, title, description, kind, setting, tags, style, triangles, textureMB, sizeM, licence, creator, made, created, downloads, installs, and the page, thumbnail, preview, download and install links.

Install into a project

An agent working in a project installs with the engine's own library toolset: it fetches the gated model at the project's quality profile and records the licence. Each result's install field is that call, ready to make.

On the web, preview is the gated model file itself (for a look before installing); download is empty until accounts arrive. Installing through the engine records the licence with the model.

{
  "toolset": "library",
  "cmd": "fetch",
  "args": {
    "id": "79f55365127c",
    "project": ".",
    "profile": "standard"
  }
}

{
  "toolset": "library",
  "cmd": "search",
  "args": {
    "text": "wooden barrel",
    "scope": "shared",
    "limit": 5
  }
}

In the Talos editor

Agents in the editor use the same library toolset on the argus tool server: search covers their own library and this marketplace's community library, fetch installs, and generate makes what is missing.

{
  "toolset": "library",
  "cmd": "search",
  "args": {
    "text": "kart",
    "scope": "all",
    "limit": 3
  }
}

Generate and share

When nothing fits, generate searches first, then stops with library-needs-approval and the price: a person approves every paid step, never the agent. The result lands in the person's library; sharing it here signs it with their name, with tags (kind and setting) chosen by the engine's tagger.

{
  "toolset": "library",
  "cmd": "generate",
  "args": {
    "prompt": "a small wooden rowing boat with two oars",
    "class": "vehicle",
    "style": "stylized-pbr",
    "project": "."
  }
}

{
  "ok": false,
  "error": {
    "code": "library-needs-approval",
    "message": "a 3D generation from text costs about US$1.10 and a person has to approve it first.",
    "estimateUsd": 1.1
  }
}

Licences

Everything listed is free: CC0 (no credit needed) or CC BY 4.0 (credit the creator). The licence filter lets a project that does not want to carry credits ask for CC0 only.

Licence	Commercial use	Credit	An agent may
CC0-1.0	Yes	No	Install
CC-BY-4.0	Yes	Required	Install and record the credit

Good manners

Search with filters rather than paging through everything; use facets to narrow.
Install once per project; the engine reuses a model it already has.
Credit CC BY creators in the game's credits.