Listing upgrade image pack API

Turn one product image into four marketplace-ready listing images with product-preserving Seedream edits.

Price$3.998per request

MethodPOST

Route/v1/content/images/listing-upgrade-pack

StatusPlanned

MIME typeapplication/json

Rate limit6/minute

CacheNo cache

contentimageimage-to-imageproductecommercepackfal

API URLhttps://x402.hexl.dev/v1/content/images/listing-upgrade-pack

Integration docs

Example request

{
  "productImageUrl": "https://example.com/source-wallet.png",
  "productName": "Matte black smart wallet",
  "marketplace": "shopify",
  "aspectRatio": "1:1"
}

Example response

{
  "requestId": "content-listing-1700000000000-abc",
  "assets": [
    {
      "url": "https://fal.media/files/example-listing-1.png"
    },
    {
      "url": "https://fal.media/files/example-listing-2.png"
    },
    {
      "url": "https://fal.media/files/example-listing-3.png"
    },
    {
      "url": "https://fal.media/files/example-listing-4.png"
    }
  ],
  "requestedCount": 4,
  "provider": "fal",
  "modelClass": "listing-image-pack",
  "retailPrice": "$1.999/request"
}

Input schema

{
  "type": "object",
  "required": [
    "productImageUrl"
  ],
  "properties": {
    "productImageUrl": {
      "type": "string",
      "format": "uri"
    },
    "productName": {
      "type": "string",
      "maxLength": 120,
      "examples": [
        "Matte black smart wallet"
      ]
    },
    "prompt": {
      "type": "string",
      "maxLength": 1500,
      "examples": [
        "Use a bright kitchen counter, one lifestyle image, one detail image, and one clean hero image"
      ]
    },
    "marketplace": {
      "type": "string",
      "enum": [
        "amazon",
        "shopify",
        "etsy",
        "tiktok-shop",
        "generic"
      ],
      "default": "generic"
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4"
      ],
      "default": "1:1"
    },
    "referenceImageUrls": {
      "type": "array",
      "maxItems": 9,
      "items": {
        "type": "string",
        "format": "uri"
      }
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "requestId",
    "assets",
    "requestedCount",
    "provider",
    "modelClass",
    "retailPrice"
  ],
  "properties": {
    "requestId": {
      "type": "string"
    },
    "assets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "width": {
            "type": "number"
          },
          "height": {
            "type": "number"
          },
          "contentType": {
            "type": "string"
          }
        }
      }
    },
    "requestedCount": {
      "type": "number"
    },
    "provider": {
      "type": "string"
    },
    "modelClass": {
      "type": "string"
    },
    "retailPrice": {
      "type": "string"
    }
  }
}