Sume video job failed: retry, new key, or switch the model?
A failed video job is final, and an Idempotency-Key replay returns the same failed job. Read the error, then retry with a new key or change models.
When a Sume video job reaches failed, read its error field first. Sume's docs say an Idempotency-Key replay returns the original job, so sending the same key again gives you the same failed job, not a new attempt. To try again, send a new key. To avoid the same failure, change something about the request.
Decision table
| Signal | Action |
|---|---|
| 400 before a job exists | Fix the request; check GET /v1/videos/models limits |
| Job status failed with an error | Read the error; retry once with a new Idempotency-Key |
| Same model fails twice | Switch to another model that lists your duration and resolution |
| Job status cancelled | Someone canceled it; do not auto-retry |
Retry rules that protect your budget
The fallback and idempotency posts below have runnable Python for the retry and model-swap steps.
- Cap retries at one per job.
- Write your intent row before you submit so a retry reuses the same business record.
- Never retry a 400; it will fail the same way.
Sources
Related posts
More in Developers
- Sume webhooks plus a sweeper: recover jobs whose callback never came
Webhook delivery can fail after 10 attempts while the Sume job still finishes. Run a sweeper that polls jobs stuck non-terminal in your own table.
- How to test a webhook URL before a Sume Format run uses it
POST /v1/webhooks/test-deliveries sends a signed webhook.test event to your URL. See the scope, the response fields, and the secret check, with no paid run.
- Transactional outbox for paid API calls in Python (Sume)
Write the Sume request and its Idempotency-Key in the order's transaction, drain later: a tested Python outbox that survives crashes, 429s and 409s.
- Transcribe a three-hour recording when the API caps at ten minutes
Streaming sessions end at an hour; Sume STT jobs take up to 600 seconds. Split with Timeline audio, transcribe 18 chunks, and stitch word times back together.
Written by Sume