Sume SDK subscribeFormatRun: 20-minute timeout vs 90-minute runs
subscribeFormatRun in @sume-com/sdk polls every 2 seconds and times out at 20 minutes by default, while a Format run can live 90. Set the timeout on purpose.
subscribeFormatRun in @sume-com/sdk polls the run, defaults to a 20 minute timeout and a 2 second interval, and resolves for any terminal status, so a failed run still resolves and you must read the status yourself. It throws SumeRunRequestError on a request problem and SumeRunTimeoutError when the clock runs out. A Format run can live up to 90 minutes, so the default can give up on a run that is still healthy.
A timeout of the helper does not stop the run or the spend. Keep the receipt id and keep polling, or switch to the webhook.
Helpers and defaults
| Helper | Default timeout | Notes |
|---|---|---|
| subscribeFormatRun | 20 minutes | 2 second poll; resolves on any terminal status |
| waitForRun | 10 minutes | Family argument is required |
| waitForJob | See SDK docs | For job ids |
Client setup
createSumeClient sends the key as x-api-key. Sending both an Authorization and x-api-key header returns 401. The client retries 408, 429 and 5xx twice, and retries a POST only when an Idempotency-Key is present, which is one more reason to set idempotency_key on every run.
Sources
Related posts
More in Formats
- sume-virtual-try-on Format: first frame, then Seedance 2.5
The sume-virtual-try-on Format builds a first frame with ChatGPT Image 2, then animates it with Seedance 2.5. What goes in, what comes back.
- Sume webhook retry schedule: 30s doubling, 10 tries, 1h cap
Sume Format run webhooks retry up to 10 times with min(max(30s x 2^(attempt-1), Retry-After), 1h). The arithmetic of that schedule and what to do when it ends.
- TikTok's Next Episode: a brand series as one Format and one queue
TikTok's The Next Episode funds creator-led series. Here is how to produce a season with Sume: one Format recipe, one bulk queue of up to 100 runs.
- Shop Creative Hub limits: 50 per upload, 10k a month, batch math
Creative Hub for GMV Max takes 50 videos per upload and 10k a month. What that means for Sume bulk queues of 100, and where the 200-video link cap bites.
Written by Sume