Skip to content
Pixii

Create anything

Generate any mix of visuals for a product in one job. Main images, gallery images, A+ content, videos, Amazon Ads creatives, and title and bullets.

Generate exactly the visuals you need for a product, in one job. Pixii analyzes the product, then produces every deliverable you list: main images, gallery images, A+ content, videos, Amazon Ads creatives, and title and bullets.

A+ Content requires a paid Pixii plan; every other deliverable is available on every plan. Each deliverable is priced on its own and the job’s credit_cost is the sum. Visuals that fail to generate are refunded individually.

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

Endpoint

POST /v2/api/create_anything

Request body

Parameter Type Required Description
brand_id number Optional The brand to work in. Take it from Brands. Defaults to your default brand.
product object Required The product to design for. Pass asin and country_code, or product_id, optionally with your own main_image and other_images. See the product fields.
deliverables object[] Required One to ten deliverables to generate. See deliverables below.
effort enum Optional Creative (default) lets the generator compose new angles and scenes; Reliable keeps every image on an angle your product photos already show.

Deliverables

Each entry of deliverables is an object:

Parameter Type Required Description
deliverable_type enum Required What to generate. See deliverable types.
platform enum Optional Target platform. Defaults to Amazon. Which platforms a type accepts is listed in the matrix below. For Video it selects the Amazon or Instagram variant of a format.
formats string[] Optional Only for A+ Content, Video and Amazon Ads. One deliverable per format, values must be unique. Defaults to the first format of the type.
reference_template image Optional A reference image (public URL or base64 bytes) whose look the visual should follow. Accepted for Main Image, Gallery Image and A+ formats other than Separate Modules.
user_prompt string Optional Creative direction for this deliverable, up to 1000 characters.

Deliverable types

deliverable_typePlatformsFormatsReference imageCredits per deliverable
Main ImageAmazon, Amazon Mobile, Shopify, Walmart, TikToknoneyes10
Gallery ImageAmazon, Amazon Mobile, Shopify, Walmart, TikToknoneyes10
Title and BulletsAmazonnoneno1
A+ ContentAmazonA+ formatsyes, except Separate Modules30, or 10 for a Single Module
VideoAmazon, Instagramvideo formatsno40
Amazon AdsAmazonad formatsno10 for the image, 40 for the videos

A+ formats

A+ Premium Seamless Modules Premium tier, one continuous image (default)
A+ Premium Separate Modules Premium tier, six standalone modules
A+ Premium Single Module Premium tier, one module
A+ Basic Seamless Modules Basic tier, one continuous image
A+ Basic Separate Modules Basic tier, six standalone modules
A+ Basic Single Module Basic tier, one module
A+ Premium Mobile Seamless Modules Premium Mobile tier, one continuous image
A+ Premium Mobile Separate Modules Premium Mobile tier, six standalone modules
A+ Premium Mobile Single Module Premium Mobile tier, one module

Video formats

Talking UGC A creator holds your product and sells it in their own words, 9:16. Amazon or Instagram (default)
Listing Video The on-page video that answers buying questions, 16:9. Amazon
360 Rotating A clean studio turntable that shows every angle. Amazon
Reels Ad A hook-led Reel with sound, cut for paid placement. Instagram

Amazon Ads formats

Sponsored Brand Image 1200 x 628 image (default)
Sponsored Brand Video 1920 x 1080, 10 seconds
Sponsored Products Video 1920 x 1080, 10 seconds

Response

A successful request returns 200 with a job id. The job runs in the background, so use the Jobs API to retrieve the result.

FieldTypeDescription
job_idstringUnique identifier for the job. Use this to poll for results.
job_typestringAlways create_anything for this endpoint.
brand_idnumberThe brand the job runs in.
session_idstringThe Pixii session that will hold the visuals, the same value the job output returns.
statusstringInitial status. Always pending on submission.
created_atstringISO 8601 timestamp of when the job was created.
credit_costnumberSum of the per-deliverable costs.
remaining_creditsnumberCredits remaining on your account after this request was accepted.

Job output

When the job completes, output contains:

FieldTypeDescription
productobjectproduct_id, asin and country_code of the product.
session_idstringThe Pixii session that holds these visuals.
campaign_adsarrayEvery generated visual as a flat list of campaign ads.

Use asset_type to tell the visuals apart and deliverable_number to group the ones that belong to the same deliverable, in request order. Video ads carry the MP4 in video_url and the poster frame in preview.

Errors

CodeHTTPDescription
VALIDATION_ERROR400One or more request parameters are invalid.
UNSUPPORTED_DELIVERABLE400A deliverable type, platform, format or reference image combination is not supported. The detail names the entry.
INVALID_IMAGE400An image is not a public URL or valid base64.
NO_ACTIVE_BRAND400No active brand found for your organization.
BRAND_NOT_FOUND404No active brand with this brand_id in your organization.
UNAUTHORIZED401Missing or invalid API key.
PAID_PLAN_REQUIRED402The request includes A+ Content and your organization is on the free plan.
INSUFFICIENT_CREDITS402Not enough credits to process this request.
RATE_LIMIT_MINUTE_EXCEEDED429Too many requests in the current minute window.
RATE_LIMIT_DAY_EXCEEDED429Daily request limit reached.
INTERNAL_ERROR500An unexpected error occurred.
SERVICE_UNAVAILABLE503Service is temporarily unavailable.

See the errors reference for the full list and how to handle each one.