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
- 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.
- Shorts ad copy: 40-character headline, 90-character description
Google recommends 40-character headlines and 90-character descriptions for the Shorts ad CTA card. Draft copy in bulk with Sume and check lengths before upload.
- Ready-made Formats for product video: the Sume Format catalog
Sume ships ready-made Formats for product and UGC-style video and images, each callable from your backend with one HTTP request at the reserved sume handle.
- What is a Sume Format? Turn an agent thread into one API call
A Sume Format is a saved video recipe your backend calls by handle and slug. One POST runs it in a fresh sandbox and returns media plus optional typed JSON.
Written by Sume