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_idimmediately. Use the Jobs API to poll for the result.
Endpoint
POST /v2/api/create_anythingRequest 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_type | Platforms | Formats | Reference image | Credits per deliverable |
|---|---|---|---|---|
Main Image | Amazon, Amazon Mobile, Shopify, Walmart, TikTok | none | yes | 10 |
Gallery Image | Amazon, Amazon Mobile, Shopify, Walmart, TikTok | none | yes | 10 |
Title and Bullets | Amazon | none | no | 1 |
A+ Content | Amazon | A+ formats | yes, except Separate Modules | 30, or 10 for a Single Module |
Video | Amazon, Instagram | video formats | no | 40 |
Amazon Ads | Amazon | ad formats | no | 10 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.
| Field | Type | Description |
|---|---|---|
job_id | string | Unique identifier for the job. Use this to poll for results. |
job_type | string | Always create_anything for this endpoint. |
brand_id | number | The brand the job runs in. |
session_id | string | The Pixii session that will hold the visuals, the same value the job output returns. |
status | string | Initial status. Always pending on submission. |
created_at | string | ISO 8601 timestamp of when the job was created. |
credit_cost | number | Sum of the per-deliverable costs. |
remaining_credits | number | Credits remaining on your account after this request was accepted. |
Job output
When the job completes, output contains:
| Field | Type | Description |
|---|---|---|
product | object | product_id, asin and country_code of the product. |
session_id | string | The Pixii session that holds these visuals. |
campaign_ads | array | Every 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
| Code | HTTP | Description |
|---|---|---|
VALIDATION_ERROR | 400 | One or more request parameters are invalid. |
UNSUPPORTED_DELIVERABLE | 400 | A deliverable type, platform, format or reference image combination is not supported. The detail names the entry. |
INVALID_IMAGE | 400 | An image is not a public URL or valid base64. |
NO_ACTIVE_BRAND | 400 | No active brand found for your organization. |
BRAND_NOT_FOUND | 404 | No active brand with this brand_id in your organization. |
UNAUTHORIZED | 401 | Missing or invalid API key. |
PAID_PLAN_REQUIRED | 402 | The request includes A+ Content and your organization is on the free plan. |
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 and how to handle each one.