Ara
Download

Search or run a command

Jump to a section or open an Ara link.

Command · import

import.initialize

Create an import sidecar with automatic importer selection and installed version.
scope edit:scenenot idempotentnon-destructive

Params

Typed as ImportInitializeParams. Fields marked * are required.

source*

string
Existing source media path, relative to the project.
required

id

option<string>
Stable asset ID or batch symbol; generated when omitted.
default null

settings

option<json>
Importer-specific settings; defaults when omitted.
default null

preset

option<CookPreset>
Source texture quality override; omitted inherits the project preset.
default null

One ofbalancedhighQualityfast

dependencies

option<list<asset>>
Referenced authoring assets used by the cook.
default null

Examples

JSON (MCP ara_apply, batches)

{
  "cmd": "import.initialize",
  "args": {
    "source": "models/crate.glb",
    "id": "as_crate"
  }
}

CLI

ara do import.initialize --args '{"source":"models/crate.glb","id":"as_crate"}' --why "…"