Skip to content

Asset library

GET/v1/assets

Returns the baked CC0 asset catalog: props, environment pieces, and set dressing served from our CDN. Listing is free and does not consume credits.

Query parameters

ParameterTypeDescription
querystringCase-insensitive substring match on name and id
categorystringExact category match. See /v1/assets/categories
packstringFilter to a pack, e.g. kenney/nature
limitintegerMax assets to return. Default 50, max 200
offsetintegerPagination offset

Response

200 OK

json
{
  "object": "list",
  "total": 214,
  "limit": 50,
  "offset": 0,
  "license": "CC0-1.0",
  "assets": [
    {
      "id": "kenney/nature/tree-pine-a",
      "name": "Tree Pine A",
      "category": "nature",
      "url": "https://cdn.cinevva.com/assets/kenney/nature/tree-pine-a.glb",
      "thumbnail": "https://cdn.cinevva.com/assets/kenney/nature/tree-pine-a.png"
    }
  ]
}

total is the number of assets matching your filters, not the page size, so paginate with offset until you have collected total items.

Categories and packs

GET/v1/assets/categories
json
{
  "object": "asset_categories",
  "total_assets": 6956,
  "categories": ["furniture", "nature", "props", "structures"],
  "packs": ["kenney/nature", "kenney/prototype", "quaternius/survival"]
}

Use this to build a filter UI without downloading the whole catalog first.

Example

bash
# Every tree in the catalog
curl "https://api.cinevva.com/v1/assets?query=tree&limit=100" \
  -H "Authorization: Bearer $CINEVVA_API_KEY"

# One pack, paginated
curl "https://api.cinevva.com/v1/assets?pack=kenney/nature&limit=50&offset=50" \
  -H "Authorization: Bearer $CINEVVA_API_KEY"

Licensing

Everything in this catalog is CC0-1.0 (public domain dedication), sourced from Kenney, Quaternius, and similar. Use, modify, and redistribute commercially with no attribution required.

That is a deliberate constraint on what we put here: assets ship inside your game, so anything requiring attribution or carrying a restrictive licence would create an obligation you did not sign up for. If a pack is not CC0, it is not in this endpoint.

Beyond the baked catalog

Cinevva also brokers live searches against external providers (sound effects from Freesound, HDRIs from Poly Haven, and others) with different licence terms per result. Those are currently reachable through the MCP server rather than /v1, because each provider carries its own attribution rules that a bulk endpoint would flatten. If you need them over HTTP, tell us what you are building.