X carousel ads: 2 to 6 media assets, rendered as one Sume batch

X's Creatives documentation lists carousel cards as 2 to 6 media assets for website or app promotion. On Sume, one Image API call with n and a single aspect_ratio makes a set that shares a ratio. The page I read gives image rules per card type, but not a separate one for carousel assets, so check the carousel card's own limits in Ads Manager before you build the full set.

What to line up

One call for the set

Request n equal to your card count. Per-model ceilings on n are lower than the API-wide 10, so read the catalog for your model.

import os, requests

API = "https://api.sume.com"
H = {"Authorization": f"Bearer {os.environ['SUME_API_KEY']}"}
body = {"model": "ideogram/ideogram-v4.5", "aspect_ratio": "1:1", "n": 4,
        "quality": "low", "output_format": "jpeg",
        "prompt": "Four product cards, same style, plain background"}
r = requests.post(f"{API}/v1/images", headers=H, json=body, timeout=90)
r.raise_for_status()
if r.status_code == 202:
    raise SystemExit("job still running")
urls = [d["url"] for d in r.json()["data"]]
assert 2 <= len(urls) <= 6, len(urls)
print(len(urls), "cards:", *urls, sep="\n")

Keep it consistent

• Same style wording in the prompt across the set.
• One ratio for every card.
• Check the width and size of each file before upload.