Skip to main content
POST
Create an asset
Set type and a human-readable alias. Use outfit for a product, model for an avatar, or another supported reusable reference type. Upload photos after creating the asset; display_image only sets its thumbnail. Reusable asset workflow →

Authorizations

Authorization
string
header
required

Create an API key in Studio → account menu → API Keys. Keep it on your server.

Body

application/json
type
enum<string>
required

Reusable asset type. Required when creating; omit when updating.

Available options:
model,
outfit,
preset,
pose,
set,
style
alias
string | null

Human-readable name.

Maximum string length: 50
sku
string | null

Product identifier for wardrobe items.

class
string | null

For presets: human_studio, human_location, ghost_mannequin, flat_lay, or product_packshot.

characteristics
string | null

Description or reusable prompt.

description
string | null

Optional descriptive text.

display_image
string | null

Thumbnail URL only. Also upload or link reference images before generating.

tag_ids
string<uuid>[] | null

Existing tag IDs.

Resource ID.

Response

Success

id
string<uuid>
required
type
string
required
created_at
string<date-time>
required
alias
string | null
required
sku
string | null
required
class
string | null
required
characteristics
string | null
required
description
string | null
required
display_image
string | null
required