asset_describe
AnalysisDescribe Asset Style
Describe the visual style of a Scenario image asset (medium, palette, lighting, composition, mood) as a reusable reference.
Args:
- asset_id: required — the image to analyze
- parameters: optional — advanced controls (modelId, seed, temperature, topP, unwantedSequences)
- dry_run: optional — true returns a cost estimate without running or charging credits
- team_id, project_id: required for OAuth callers
Returns: a full description plus a short promptable synthesis. With dry_run=true, returns a cost estimate.
For instruction-driven or interactive analysis (specific questions, custom output format), use asset_analyze (Scenario LLM) instead — it is more flexible than this fixed endpoint.
read-onlyidempotentopen-world
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| asset_id | string | ✓ | Scenario asset ID of the image to describe as a style reference. |
| parameters | record | — | Advanced controls passed through to the API (modelId, seed, temperature, topP, unwantedSequences). |
| dry_run | boolean | — | Estimate cost without running. Sends ?dryRun=true so the API returns the cost estimate without executing or charging credits. |
| team_id | string | — | Team ID. Required if user belongs to multiple teams. |
| project_id | string | — | Project ID to scope the operation to. |
| response_format | enum(json | markdown) | json | Output format: 'json' for structured data, 'markdown' for human-readable text. |
Example Request
JSON
{
"asset_id": "asset_img001",
"team_id": "team_abc123",
"project_id": "proj_xyz789"
}Example Response
JSON
{
"source_asset_id": "asset_img001",
"description": "Flat-shaded isometric game art with a warm palette and soft rim lighting.",
"synthesis": "isometric, flat shading, warm palette, soft rim light"
}Common Use Cases
- Analyze image style before fine-tuning a model on similar content
- Extract a promptable style synthesis from a reference image