Lost an avatar render? List them with GET /v1/avatar-videos
Did not save the job id of a Sume avatar render? List your avatar-video resources with GET /v1/avatar-videos, then read one by id for its video_url.
If you lost the job id of an avatar render, list the resources. GET /v1/avatar-videos returns your avatar-video resources, and GET /v1/avatar-videos/:id reads one (Generate avatar video). Completed results include public media.sume.com video artifacts, so you do not have to render again.
The two calls
Both take your API key as a Bearer token:
GET /v1/avatar-videos: the list.GET /v1/avatar-videos/avatar_video_123: one resource.GET /v1/jobs/:id/result: the job result, if you still have the job id.
Avatars have a list too
GET /v1/avatar-1.0/avatars lists your avatars and GET /v1/avatar-1.0/avatars/:id reads one. The older /v1/avatars paths are compatibility routes with the same response shape.
Do not resubmit to find it
A new submit is a new paid job. Read the resource first. When you do resubmit, use an Idempotency-Key, as described in Jobs and results.
Sources
Related posts
More in Developers
- List your transcription jobs: GET /v1/jobs by type, status, cursor
GET /v1/jobs?type=speech_to_text pages 100 jobs at a time, newest first. Join on each row's idempotency_key, not array position, to rebuild a batch.
- Live webinar captions: Sume has no streaming STT, so use chunks
MAI-Transcribe-2-Streaming is $0.54 an hour. Sume STT is $0.60, async and capped at 10 minutes a job. How to caption a webinar recording in chunks.
- Log Sume ratelimit-remaining on every Python urllib response
A urllib handler that logs ratelimit-remaining and ratelimit-reset on each Sume response, warning under 10 percent. It also sees 429 replies.
- Lost a Sume video job id? Recover and download it with the CLI
A restart or timeout does not lose a Sume job. Use sume jobs list, status, watch and download to recover the clip without paying for a second generation.
Written by Sume