POST /amazon/listing-images

Overview

Generates output image URLs suitable for listing pipelines, with shot mapping support via shotId.

Required scope: amazon:listing-images:write

Supported types: hero, hook, lifestyle, detail, scale, closer, custom

Request Example

curl -X POST "https://rendery3d.com/api/enterprise/v1/amazon/listing-images" \
  -H "Authorization: Bearer $RENDERY3D_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-request-id: listing-image-job-20260216-001" \
  -d '{
    "type": "hero",
    "images": ["https://cdn.example.com/source-product.jpg"],
    "productTitle": "Wireless Meat Thermometer",
    "userPrompt": "Ultra-clean premium catalog hero shot on pure white background",
    "shotId": "shot_1",
    "shotLabel": "Hero Image"
  }'

Request Fields

Field	Type	Required	Notes
type	string	yes	Shot intent. One of hero, hook, lifestyle, detail, scale, closer, custom.
images	string[]	yes	One or more source images (URL or data URL), max 6 entries.
userPrompt	string	no	Additional instruction for non-custom shot types.
customPrompt	string	only for custom	Required when type is custom.
productTitle	string	no	Optional product context used in prompt composition.
shotId	string	no	Your internal shot identifier for mapping and reporting.
shotLabel	string	no	Readable label stored with generation metadata.
projectId	string	no	Optional project grouping id for persisted generations.

Try This Endpoint

Enter your API key and run a real request from this browser session.

Required scope: amazon:listing-images:write

API KeyRequest Body (JSON)

Generated cURL

curl -X POST "https://rendery3d.com/api/enterprise/v1/amazon/listing-images" \
  -H "Authorization: Bearer $RENDERY3D_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "hero",
  "images": ["https://cdn.example.com/source-product.jpg"],
  "productTitle": "Wireless Meat Thermometer",
  "userPrompt": "Ultra-clean premium catalog hero shot on pure white background",
  "shotId": "shot_1",
  "shotLabel": "Hero Image"
}'

Response 200

{
  "success": true,
  "generation": {
    "id": "9fd0...",
    "type": "hero",
    "shotId": "shot_1",
    "shotLabel": "Hero Image",
    "outputUrl": "https://.../generated.jpg",
    "previewUrl": "https://.../generated-preview.webp"
  }
}

Errors

400 invalid body, unsupported type, or input limit exceeded
401 missing/invalid API key
402 insufficient credits
403 missing scope or plan access
429 rate limit exceeded
500/502 generation or provider failure