Product-commercial Format: one gift-set hero clip for a store page

What the Format is for

sume-product-commercial makes "a finished premium product commercial with a controlled hero composition, tactile material detail, elegant lighting, and one cinematic camera move" for launch films, ecommerce hero videos, product teasers and brand-forward clips.

A gift set suits it because the set is one hero object: box, ribbon and contents. Ask for a single move across the packaging and hold the final frame so a store page can loop it.

A call you can run

Send the creative direction in instruction and any product or person image in attachments (images only, up to 30, public HTTPS). The run is one unattended turn, so name everything it needs to choose. generation_spend_cap_usd bounds the generation spend, and a Format without its own cap inherits $400, with $500 the platform maximum.

curl -sS -X POST "https://api.sume.com/v1/formats/sume/sume-product-commercial/runs" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gift-hero-1" \
  -d '{
    "instruction": "Boxed gift set with ribbon on pale linen, soft window light, slow lateral slide, end on a held front shot. 4:5.",
    "attachments": [{ "type": "input_image", "image_url": "https://cdn.example.com/giftset.png" }],
    "generation_spend_cap_usd": 40
  }'

Review before you reuse it

Revise with previous_run_id instead of rewriting the brief. A new run that continues an earlier one carries its context, and you can change only the part that failed review. Run the same brief with two different aspect ratios as separate runs when a store page and a feed need different crops.

After the run

A finished run gives primary_output_url and artifacts[]. Media is mirrored to durable media.sume.com URLs, and anyone who holds a URL can open it. Poll the run or pass communication.webhook_url to receive format.run.terminal. To change the result, start a new run with previous_run_id rather than a new brief from zero.