asset_display
Display one BeatBandit asset with inline image rendering or media-ready metadata.
When to use
Use when the caller already has one exact asset and wants to show it after `image_generate`, `video_generate`, `media_generate`, or `project_assets_query`.
Use `source_type=scene_moodboard_asset` to inspect a generated Scene Moodboard.
Use `format=display` for image-friendly inline presentation plus fallback media links, and `format=json` or `format=markdown` for metadata-first inspection.
When not to use
Do not use for broad filtered asset listing; use `project_assets_query` instead.
Do not use for generation or mutation flows.
Examples
“Show the storyboard asset that was just generated for this shot.”
“Show the scene moodboard asset that was just generated for this scene.”
“Show the latest generated video asset for this project.”
“Display one audio asset with metadata and a playback/download URL.”
Anti-examples
- List all music assets for this project.
- Generate a new shot image.
Backend capabilities
Linked resources
Tool calls may return resource_links pointing at these resource families.
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"project_id",
"source_type",
"asset_id"
],
"properties": {
"project_id": {
"type": "integer"
},
"source_type": {
"type": "string",
"enum": [
"shot_asset",
"shot_element_asset",
"scene_moodboard_asset",
"video_asset",
"media_asset"
]
},
"asset_id": {
"type": "integer"
},
"format": {
"type": "string",
"enum": [
"display",
"json",
"markdown"
],
"default": "display"
}
},
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"project_id",
"source_type",
"asset_id",
"kind",
"asset_updated_at"
],
"properties": {
"project_id": {
"type": "integer"
},
"source_type": {
"type": "string",
"enum": [
"shot_asset",
"shot_element_asset",
"scene_moodboard_asset",
"video_asset",
"media_asset"
]
},
"asset_id": {
"type": "integer"
},
"format": {
"type": "string",
"enum": [
"display",
"json",
"markdown"
]
},
"kind": {
"type": "string",
"enum": [
"image",
"video",
"audio",
"other"
]
},
"display_name": {
"type": "string"
},
"status": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_format": {
"type": [
"string",
"null"
]
},
"width": {
"type": [
"integer",
"null"
]
},
"height": {
"type": [
"integer",
"null"
]
},
"duration_seconds": {
"type": [
"number",
"string",
"null"
]
},
"download_url": {
"type": [
"string",
"null"
]
},
"stream_url": {
"type": [
"string",
"null"
]
},
"thumbnail_url": {
"type": [
"string",
"null"
]
},
"thumbnail_asset_id": {
"type": [
"integer",
"null"
]
},
"thumbnail_source_type": {
"type": [
"string",
"null"
],
"enum": [
"shot_asset",
"shot_element_asset",
"scene_moodboard_asset",
"video_asset",
"media_asset",
null
]
},
"thumbnail_mime_type": {
"type": [
"string",
"null"
]
},
"inline_image_included": {
"type": "boolean"
},
"inline_preview_image_included": {
"type": "boolean"
},
"inline_audio_included": {
"type": "boolean"
},
"inline_video_resource_included": {
"type": "boolean"
},
"asset_updated_at": {
"type": "string",
"format": "date-time"
},
"resource_links": {
"type": "array",
"items": {
"type": "object",
"required": [
"family",
"uri"
],
"properties": {
"family": {
"type": "string"
},
"uri": {
"type": "string"
}
},
"additionalProperties": false
}
},
"asset": {
"type": "object"
}
},
"additionalProperties": true
}