Clone

Replicate a visual identity across your catalog by cloning reference assets onto a new ASIN.

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.

Request

curl -X POST https://api.pixii.ai/v1/api/scale \
-H "Authorization: Bearer pk_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
  "asin": "B08N5WRWNW",
  "country_code": "US",
  "scale_mode": "catalog",
  "main_image_input": "https://example.com/main.jpg",
  "other_images_input": ["https://example.com/1.jpg"],
  "user_prompt": "match the navy palette",
  "items": [
    {
      "preview_url": "https://example.com/preview.png",
      "platform": "Amazon",
      "asset_type": "Product Photo"
    }
  ]
}'

import requests

response = requests.post(
"https://api.pixii.ai/v1/api/scale",
headers={
"Authorization": "Bearer pk_live_xxxxxxxxxxxx",
"Content-Type": "application/json",
},
json={
"asin": "B08N5WRWNW",
"country_code": "US",
"scale_mode": "catalog",
"main_image_input": "https://example.com/main.jpg",
"other_images_input": ["https://example.com/1.jpg"],
"user_prompt": "match the navy palette",
"items": [
{
"preview_url": "https://example.com/preview.png",
"platform": "Amazon",
"asset_type": "Product Photo",
}
],
},
)

Response json

{

"success": true,
"data": {
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"job_type": "Clone",
"status": "pending",
"created_at": "2026-04-07T12:00:00Z",
"remaining_credits": 2480
},
"error": null
}

Error response json

{

"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"detail": "items.0.asset_type \"Main Image\" is not valid for platform \"Shopify\". Allowed: Product Photo"
}
}

See the errors reference for the full list of error codes and how to handle them.