asset_describe

Analysis

Describe 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

NameTypeRequiredDescription
asset_idstringScenario asset ID of the image to describe as a style reference.
parametersrecordAdvanced controls passed through to the API (modelId, seed, temperature, topP, unwantedSequences).
dry_runbooleanEstimate cost without running. Sends ?dryRun=true so the API returns the cost estimate without executing or charging credits.
team_idstringTeam ID. Required if user belongs to multiple teams.
project_idstringProject ID to scope the operation to.
response_formatenum(json | markdown)jsonOutput 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