Reference · Jobs
A job’s stage, its files, or why it failed
Check on work that finishes later — a video, a talking avatar, an influencer clip, a music track, a UGC ad, an edit or upscale, a captioned clip, a board card, a board’s Run all, picture ads, a story, or a picture still being made when its call stopped waiting — by the {kind, id} a create tool returned (or one GET /api/v1/work lists). Answers whether it is working (with the stage it is really at, in words), done (with links to the finished files, good for about 7 days), or failed (with the reason, and whether it was charged). A video, talking avatar or influencer clip also says what it was made from, as its page shows: its start and end frames, reference pictures, clips and sounds by the prompt’s names for them (@Image1, @Video1, @Audio1), and the video it carried on or edited, each with a link to open it; a UGC ad its presenters, product, pictures, video and voices by its tags (@Presenter1, @Product1), and picture ads their product, the ad they remade and the model. There is no progress percentage or time estimate: call again later to check. Pictures and voiceovers come back from their create tools once made; only a picture from a slow model, still being made when its call stopped waiting, comes back as a job (kind "image"). Free.
- Key needs
account:read· See your account- Spends
- Nothing
- Answers
- Data
curl https://vessero.com/api/v1/jobs/video.8f1c2d3e-4b5a-4789-8abc-def012345678 \ -H "Authorization: Bearer $VESSERO_API_KEY"
{ "object": "job", "id": "video.8f1c2d3e-4b5a-4789-8abc-def012345678", "kind": "video", "status": "done", "stage": "Finished", "files": [ { "kind": "video", "url": "https://vessero.com/f/Qm3xT8aLp2Vd9WcZ" } ], "url": "/api/v1/jobs/video.8f1c2d3e-4b5a-4789-8abc-def012345678" }
Path
- jobIdstringrequiredA job id, as a create or a job read gave it:
video.8f1c….
Answers
- 200okThe answer, as data.
- 404not_foundNot found on this account.
- 429rate_limitedToo many calls this minute: see Retry-After.