Luma callback_url or polling: which Sume job mode matches

Luma's API docs list keyframes, loop and callback_url for ray-2. On Sume the equivalent choice is job mode: async, sync up to 30 s, subscribe or webhook.

4 min readSume
All posts

If you used Luma's callback_url, the closest Sume setting is webhook mode on the job; if you polled Luma, use async and poll the job status. Luma's video generation docs list ray-2 and ray-flash-2, resolutions 540p, 720p, 1080p and 4K, keyframes, loop, concepts and callback_url. Sume's jobs expose four modes.

Completion patterns (read 2026-10-03)
PatternLuma API docsSume
Poll until doneNot covered by the page readasync mode: GET /v1/jobs/{id}/status then /result
Push on finishcallback_urlwebhook mode
Wait inlineNot listedsync mode, waits at most 30 s; subscribe is an alias of sync

Choosing a mode

Video renders usually outlast the 30 second sync window, so sync suits short jobs and polling or webhooks suit the rest. Use webhook mode when a server can receive requests and you do not want a polling loop. Use async when the caller is a script or a laptop with no public address.

What to verify on a Sume webhook

Sume signs each delivery with HMAC SHA256 over <timestamp>.<raw_body>, sent as x-sume-webhook-signature: sume-v1=<hex>. Verify against the raw bytes, refuse to run with an empty secret, and expect redelivery: up to 10 attempts, 30 seconds apart, with a 10 second timeout on your endpoint. A redeliver endpoint exists for missed events. Details are on the webhooks page.

  • Return a 2xx quickly and do the work after.
  • Treat the same event arriving twice as normal.
  • Keep a polling fallback for jobs with no event after your own timeout.

A caveat on the Luma side

Luma's public API docs list Ray 2, while the news page lists newer Ray3.2 and Ray3.14 releases. The docs may lag the product, so check which models your key can call before you map parameters.

Sources

Related posts

More in Developers

All Developers posts

Written by Sume