Clone — Pixii API

Replicate a visual identity across your catalog. Provide one or more reference assets and Clone generates a matching visual for the target ASIN from each one. Every item you send comes back as a generated asset of the same platform and asset type as the reference it was cloned from.

Users often call this “scale”. Both names mean this endpoint, and the path stays /v1/api/scale.

This is an async endpoint. It returns a job_id immediately. Use the Jobs API to poll for the result.

Endpoint

POST /v1/api/scale

Request body

Parameter	Type	Required	Description
`asin`	`string`	Required	Amazon Standard Identification Number.
`country_code`	`string`	Required	Target marketplace. See the supported marketplaces list.
`scale_mode`	`enum`	Required	How Clone should generate the new assets. See scale modes below.
`main_image_input`	`string`	Optional	URL of the product's main image. Must be a publicly accessible image URL.
`other_images_input`	`string[]`	Optional	Additional product image URLs. Minimum 1 item if provided.
`user_prompt`	`string`	Optional	Optional natural-language guidance for the generation. Cannot be empty if provided.
`items`	`ScaleItem[]`	Required	Reference assets to clone from. Minimum 1 item. See item shape below.

Scale modes

The scale_mode field accepts one of:

catalog: Apply the reference visuals across all your products
inspire: Use the references visuals as creative inspiration
variation: Generate variations - color/size/flavour
language: Translate copy on the provided visual to a new language. You must specify language in the user_prompt

Item shape

Each entry in items describes one reference asset you are supplying. Its platform and asset_type describe that reference, and they are also what Pixii generates from it: send an Amazon / Main Image reference and you get back an Amazon main image for the target ASIN.

Parameter	Type	Required	Description
`preview_url`	`string`	Required	Publicly accessible URL of the reference asset to clone from.
`platform`	`enum`	Required	Platform this reference asset belongs to, and the platform the generated asset is produced for. See platforms below.
`asset_type`	`enum`	Required	Asset type of this reference, and of the asset generated from it. Valid values depend on `platform`.

Platforms and asset types

platform accepts:

Amazon: Amazon desktop product page
Amazon Mobile: Amazon mobile product page
Shopify: Shopify product page
TikTok: TikTok Shop product page
Walmart: Walmart product page

asset_type accepts Product Photo or Main Image. Pixii returns a VALIDATION_ERROR for a combination it does not support.

Platform	Allowed asset types
`Amazon`	`Product Photo`, `Main Image`
`Amazon Mobile`	`Product Photo`, `Main Image`
`Shopify`	`Product Photo`, `Main Image`
`TikTok`	`Product Photo`, `Main Image`
`Walmart`	`Product Photo`, `Main Image`

Response

A successful request returns 200 with a job ID. Same response shape as Listing Builder — see the Jobs API for the polling result format. Completed Clone jobs report job_type: "Clone".

Errors

Code	HTTP	Description
`VALIDATION_ERROR`	400	One or more request parameters are invalid (including unsupported `platform` × `asset_type` combinations).
`NO_ACTIVE_BRAND`	400	No active brand found for your organization.
`UNAUTHORIZED`	401	Missing or invalid API key.
`INSUFFICIENT_CREDITS`	402	Not enough credits to process this request.
`RATE_LIMIT_MINUTE_EXCEEDED`	429	Too many requests in the current minute window.
`RATE_LIMIT_DAY_EXCEEDED`	429	Daily request limit reached.
`INTERNAL_ERROR`	500	An unexpected error occurred.
`SERVICE_UNAVAILABLE`	503	Service is temporarily unavailable.

See the errors reference for the full list.