Skip to main content
POST
Split an image into layers

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Body

application/json
sourceId
string
required

The image to decompose: the sourceId of an image source from POST /v1/sources (kind: "image") after uploading the bytes, or an image library item's sourceId. At least 512×512 pixels.

Minimum string length: 1
Example:

"su_abc123def456"

model
enum<string>

seedream-5.0-pro (default) gives the cleanest layers; seedream-5.0-flash is faster.

Available options:
seedream-5.0-pro,
seedream-5.0-flash
Example:

"seedream-5.0-pro"

prompt
string

Which elements to split out, e.g. 'the pricing card, the Upgrade button and the headline'. Regions can be named as left top right bottom in thousandths of the image. Leave it out to split out every main element.

Maximum string length: 4000

Response

Decomposed and saved to the private library

base
object
required

The clean plate: the image with the layers' elements removed and the space behind them filled in

layers
object[]
required