create_object_pro_flash
Generates a saved pixel-art object from a text description, with optional 8-direction rotation views. Reuse an existing image to reduce generation costs.
Instructions
Create a saved object with the Pro Flash engine in one call: generates a south-facing image from the description and, with n_directions 8, adds v3 rotation views (n_directions 1 = single image). Pass source_image_id or first_frame to reuse an existing image: one-direction finalization is then free and eight views charge only rotations. Objects have no skeleton. Returns a job plus object_id; poll get_job_status for billing_stages, then get_object.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name (max 200 chars) | |
| seed | No | Recorded seed (default 0); the Pro Flash provider does not promise deterministic output | |
| view | No | Camera view (default 'low top-down') | |
| image_size | No | Size for text creation. Native sizes: 16x16 (experimental), 24x24, 32x32, 32x48, 64x64, 96x64, 96x96. Custom (Beta): 16-256 per side, both multiples of 4. Defaults to 64x64 | |
| description | Yes | Object description (max 2000 chars) | |
| first_frame | No | South-facing PNG to use instead of generating one. Mutually exclusive with source_image_id | |
| style_image | No | Optional style reference ('left-box' image) whose visual traits are copied into the result. Must fit the operation's native canvas | |
| n_directions | No | 1 = single image, 8 = full rotation set (default 8) | |
| style_options | No | Which visual traits to copy from style_image (all default true) | |
| source_image_id | No | Owned south-facing image ID from a Pro Flash image job — reuses its pixels free of the image charge. Mutually exclusive with first_frame | |
| first_frame_direction | No | Direction the supplied/generated first frame faces (default 'south') |