Skip to content

Technical Updates

This section lists mostly technical updates such as file name or API changes that are mainly relevant for power-users or developers. General announcements are made via Patreon.

Upcoming changes that have not yet been implemented are marked using the Draft tag.

  • 2 min read

Upcoming changes to the ambientCG API

A major update to the ambientCG website is scheduled to release at some point in late 2024 or early 2025. It can already be tested on beta.ambientCG.com and introduces new features and a more interactive user experience.

As a part of these updates, some changes to the underlying data model were necessary which will lead to a new API (v3) which will be announced at a later time. The existing APIs (v1/v2) will continue to work mostly as usual. However, some differences will be noticeable once the update is deployed:

Both v1 and v2 currently offer two separate download links, one using a HTTP redirect and one linking to the CDN directly. When the API was introduced this feature was implemented to accommodate certain CLI-based downloading tools which had trouble following HTTP redirects. Now, several years later, I have decided to retire this "split" and only offer the redirect-based links in the interest of more accurate statistics. For compatibility reasons, both fields will still be offered, but they will contain the same link. The vast majority of HTTP-libraries and tools should have absolutely no trouble with this change.

Removal of the thumbnailAssetId field in /v2/categories_json

Currently, the list of asset categories displays a thumbnailAssetId that is used as a "representative asset" for this category. The new version of the site displays categories in a different way and no longer stores such a "thumbnail asset". The value is therefore permanently set to null.

Changes to the creationMethod field

Both API versions contain a field describing the creationMethod of an asset. The new version of the site stores this information in a different way which is not easily representable as a single string. Therefore, many assets will have their creationMethod changed to UnknownOrOther.

Changes to data inclusion in /v2/full_json endpoint

The /v2/full_json endpoint allows clients to tailor the response data to their needs and to improve query performance using the include=X,Y,Z,... HTTP parameter. The list of possible values for this parameter will change to the following values:

  • statisticsData
  • labelData
  • relationshipData
  • fileData
  • previewData
  • technicalData

Queries using the OLD parameters will (mostly) be converted into the new format, but adjustments to this parameter may still be necessary.

Testing the changes

All upcoming changes can already be tested on beta.ambientCG.com. Please get in touch if you encounter any unexpected bugs, performance issues, inconsistencies or other problems.

  • 1 min read

AssetFetch endpoint for ambientCG Materials

Earlier this year I announced my intentions to build AssetFetch, a system for building easy asset discovery and import solutions without the redundancy normally associated with developing a new software plugin for every software / asset vendor combination. The specification and more info about this system is available on assetfetch.org.

In order to bring this system into the real world the first implementation of the provider-side of AssetFetch is now available using the following initialization endpoint: https://ambientcg.com/api/af/init.

This endpoint serves materials (currently only materials) from ambientCG via the AssetFetch protocol v0.3. Because the AF spec is still actively being worked on there is currently only one version available, future implementations (post 1.0) may endpoint versioning to improve stability.

A first client implementation for Blender is being developed in parallel on GitHub.

The availability of the "traditional" ambientCG API (v2) is not affected by this and any changes to it will be announced in advance on this blog.

  • 3 min read

New names for HDRI assets

Since 2021, more than 130 HDRIs have been added to ambientCG.com. Previously, these HDRIs were only grouped in two categories (Outdoor and Indoor) with a third category for the "sky-only" variants. With the growing collection this categorization slowly became meaningless which is why it was updated to also include the time of day.