A holiday ad brief as one JSON file that drives every Sume call
Keep one JSON brief with the product, offer, date and ratios, and have a script read it for each Sume call so every asset says the same thing.
Keep a single JSON brief with the product, offer line, date and ratios, and read it in the script that calls Sume for stills, clips, captions and the Timeline. Every asset then repeats the same offer and date.
A minimal brief
Only the fields you actually use.
{
"product": "Cedar candle, 8 oz",
"offer": "20% off through Nov 30",
"ratios": ["9:16", "1:1", "4:5"],
"clip_seconds": 5,
"model": "sume/auto"
}Map brief to calls
Each field maps to a request.
| Brief field | Used by |
|---|---|
| product | image and video prompts |
| offer | caption cues |
| ratios | image size and Timeline fit |
| model | POST /v1/videos |
Retries
Send an Idempotency-Key per call so a network retry cannot bill twice.
Version it
Commit the brief so you can see what changed between the Black Friday and Cyber Monday runs.
Sources
Related posts
More in Developers
- How big is a 3-minute Short at YouTube's 8 Mbps? About 189 MB
A 180-second 1080p Short at YouTube's 8 Mbps video and 384 kbps audio is about 189 MB. Here is the arithmetic, the TikTok ad caps, and the Sume probe field.
- How do I know a new TTS model is available on Sume?
Every week brings a new voice model. The live answer is one GET request: list the TTS Router catalog. What an unknown id returns, and how to avoid hard-coding.
- How long AI video vendors keep your file: Veo 2 days, Higgsfield 7+
Veo keeps videos two days, Higgsfield files at least seven, Sora Batch outputs were kept 24 hours. Retention facts and a download-on-complete script.
- How many image models does Sume list? Count them with a script
Sume's image catalog lists 19 ids plus sume/auto. Count text-only versus edit-capable rows live from the API instead of trusting a number in a blog post.
Written by Sume