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
asset.display
Linked resources
Tool calls may return resource_links pointing at these resource families.
Input schema
asset_display input
{
"$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
asset_display output
{
"$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
}← All toolsv1 · query_tool