A+ Content

Generate Amazon A+ Content modules — Basic, Premium, and Premium Mobile — from an ASIN.

Generate Amazon A+ Content for a given ASIN. Pixii produces a full set of A+ modules — Basic, Premium, or Premium Mobile — ready to drop into Seller Central, along with a single composite preview image for each variant.

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

Endpoint

POST /v1/api/a_plus

Request body

Parameter	Type	Required	Description
`asin`	`string`	Required	Amazon Standard Identification Number.
`country_code`	`string`	Required	Target marketplace. See the supported marketplaces list.
`types`	`enum[]`	Required	One or more A+ Content variants to generate. 1–10 unique values. See content types below.
`main_image_url`	`string`	Optional	URL of the product's main image. Must be a publicly accessible image URL.
`other_image_urls`	`string[]`	Optional	Additional product image URLs. Minimum 1 item if provided. Must be publicly accessible image URLs.
`user_prompt`	`string`	Optional	Optional natural-language guidance for the generation. Cannot be empty if provided.

Content types

The types array accepts one or more of:

A+ Basic Separate Modules A+ Basic with each module generated as its own standalone image — 30 credits

A+ Basic Full Image A+ Basic as one continuous design, sliced into 4 modules — 30 credits

A+ Basic One Module A single standalone A+ Basic module — 10 credits

A+ Premium Separate Modules A+ Premium with each module generated as its own image — 30 credits

A+ Premium Full Image (6 modules) A+ Premium as one continuous design, sliced into 6 modules — 30 credits

A+ Premium Full Image (4 modules) A+ Premium as one continuous design, sliced into 4 modules — 30 credits

A+ Premium One Module A single standalone A+ Premium module — 10 credits

A+ Premium Mobile Separate Modules Mobile-optimized A+ Premium with each module generated as its own image — 30 credits

A+ Premium Mobile Full Image Mobile-optimized A+ Premium as one continuous design, sliced into 4 modules — 30 credits

A+ Premium Mobile One Module A single standalone mobile A+ Premium module — 10 credits

Credits

The total credit_cost is the sum of the per-type costs for the variants you request. For example, requesting A+ Basic Separate Modules, A+ Premium Full Image (6 modules), and A+ Basic One Module costs 30 + 30 + 10 = 70 credits. If a specific variant fails to generate, its credits are automatically refunded — see credits_refunded on the polled job.

Result shape

When the job completes, output.ads contains one entry per requested type. The shape differs slightly from other Pixii endpoints — A+ exposes per-type metadata and the individual module images alongside the composite preview.

Field	Type	Description
`ads[].type`	string \| null	The requested A+ variant — one of the content types
`ads[].preview`	string \| null	Signed URL for the composite preview image. Valid for 7 days. `null` if the variant failed
`ads[].modules`	string[]	Signed URLs for each individual A+ module image, in order. Empty if the variant failed
`ads[].error`	object \| null	Error details if this variant failed. `null` on success
`ads[].error.code`	string	Job error code — see Job errors
`ads[].error.message`	string	Human-readable error message

For status, timestamps, and the rest of the polled job envelope, see the Jobs API.

Errors

Code	HTTP	Description
`VALIDATION_ERROR`	400	One or more request parameters are invalid.
`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 and how to handle each one.

Request

curl -X POST https://api.pixii.ai/v1/api/a_plus \
-H "Authorization: Bearer pk_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
  "asin": "B08XBGZ4R6",
  "country_code": "IN",
  "types": [
    "A+ Basic Separate Modules",
    "A+ Premium Full Image (6 modules)",
    "A+ Basic One Module"
  ]
}'

import requests

response = requests.post(
"https://api.pixii.ai/v1/api/a_plus",
headers={
"Authorization": "Bearer pk_live_xxxxxxxxxxxx",
"Content-Type": "application/json",
},
json={
"asin": "B08XBGZ4R6",
"country_code": "IN",
"types": ["A+ Basic Separate Modules", "A+ Premium Full Image (6 modules)", "A+ Basic One Module"],
},
)

Response json

{

"success": true,
"data": {
"job_id": "facbb691-9ce5-4ee2-bd40-ab95df8a7a1d",
"job_type": "A+ Content",
"status": "pending",
"created_at": "2026-05-01T20:51:57.827Z",
"remaining_credits": 2410
},
"error": null
}

Completed job output json

{

"success": true,
"data": {
"id": "facbb691-9ce5-4ee2-bd40-ab95df8a7a1d",
"job_type": "A+ Content",
"status": "completed",
"created_at": "2026-05-01T20:51:57.827Z",
"started_at": "2026-05-01T20:51:57.875Z",
"completed_at": "2026-05-01T20:53:11.044Z",
"credit_cost": 70,
"credits_refunded": 0,
"output": {
"ads": [
{
"type": "A+ Basic Separate Modules",
"preview": "https://storage.googleapis.com/.../preview-basic.png",
"modules": [
"https://storage.googleapis.com/.../A_PLUS_BASIC_1.jpg",
"https://storage.googleapis.com/.../A_PLUS_BASIC_2.jpg",
"https://storage.googleapis.com/.../A_PLUS_BASIC_3.jpg",
"https://storage.googleapis.com/.../A_PLUS_BASIC_4.jpg",
"https://storage.googleapis.com/.../A_PLUS_BASIC_5.jpg"
],
"error": null
},
{
"type": "A+ Premium Full Image (6 modules)",
"preview": "https://storage.googleapis.com/.../preview-premium.png",
"modules": [
"https://storage.googleapis.com/.../A_PLUS_PREMIUM_1.jpg",
"https://storage.googleapis.com/.../A_PLUS_PREMIUM_2.jpg",
"https://storage.googleapis.com/.../A_PLUS_PREMIUM_3.jpg",
"https://storage.googleapis.com/.../A_PLUS_PREMIUM_4.jpg",
"https://storage.googleapis.com/.../A_PLUS_PREMIUM_5.jpg",
"https://storage.googleapis.com/.../A_PLUS_PREMIUM_6.jpg"
],
"error": null
},
{
"type": "A+ Basic One Module",
"preview": "https://storage.googleapis.com/.../preview-basic-one-module.png",
"modules": [
"https://storage.googleapis.com/.../A_PLUS_BASIC_ONE_MODULE_1.jpg"
],
"error": null
}
]
},
"error_code": null
},
"error": null
}

Error response json

{

"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"detail": "types: must contain at least 1 element"
}
}

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