Media assets

Media asset endpoints let you upload images or videos to managed storage before using them as world-generation inputs.

Prepare media asset upload

POST /marble/v1/media-assets:prepare_uploadCreate a media asset record and receive the signed upload URL and required headers.

GET /marble/v1/media-assets/{media_asset_id}Retrieve metadata for an uploaded media asset.

Prepare the upload

Call Prepare media asset upload with the file name, extension, and media kind.

Upload bytes

Send the file to the returned signed URL with the required headers from the response.

Reference the asset

Use the returned media_asset_id in Generate a world.

⌘I