Media assets
Get media asset
Get a media asset by ID.
Retrieves metadata for a previously created media asset.
Args: media_asset_id: The media asset identifier.
Returns: MediaAsset object with media_asset_id, file_name, extension, kind, metadata, created_at, and updated_at.
Raises: HTTPException: 404 if not found
GET
Get Media Asset
Authorizations
API key for authentication. Get your key from the developer portal.
Path Parameters
Response
Successful Response
A user-uploaded media asset stored in managed storage.
MediaAssets can be images, videos, or binary blobs that are used as input to world generation.
Creation timestamp
File name
High-level media type
Available options:
image, video Examples:
"image"
"video"
Server-generated media asset identifier
File extension without dot
Example:
"mp4"
Optional application-specific metadata
Last update timestamp
Previous
Generate a WorldStart world generation.
Creates a new world generation job and returns a long-running operation.
Poll the /operations/{operation_id} endpoint to check generation status
and retrieve the generated world when complete.
Args:
request: The world generation request containing world_prompt, display_name,
tags, model, seed, and permission settings.
Returns:
GenerateWorldResponse with operation_id and timestamps. Use the operation_id
to poll for completion.
Raises:
HTTPException: 400 if invalid request or content violates policies
HTTPException: 402 if insufficient credits
HTTPException: 500 if generation could not be started
Next
Get Media Asset