Scale

Replicate a visual identity across your catalog by cloning a reference asset onto new ASINs.

Replicate a visual identity across your catalog. Provide one or more reference assets and Scale will generate matching visuals for the target ASIN, optimized for the platform and asset type you specify.

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 Scale 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:

Parameter	Type	Required	Description
`preview_url`	`string`	Required	Publicly accessible URL of the reference asset.
`platform`	`enum`	Required	Target platform for this asset. See platforms below.
`asset_type`	`enum`	Required	Asset type for this item. 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

asset_type accepts Product Photo or Main Image. Not every asset type is valid for every platform — Pixii will return a VALIDATION_ERROR for unsupported combinations.

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

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.

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": "Scale",
"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.