Skip to content
Get your keyGet a key

Reference · Jobs

GET/jobs/{jobId}

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 recording’s transcript, 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 job 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), failed (with the reason, and whether it was charged), or waiting: a UGC ad made step by step whose preview is ready, its link handed back like a finished file, and its video not made until the person says yes — POST /api/v1/ugc-ads/{adId}/video makes it and POST /api/v1/ugc-ads/{adId}/picture draws a preview again, each quoted first. A transcript, once made, comes back as its words rather than a file: its lines with their times and speakers (a translation: sentences, with neither), and its SRT subtitles where it has times; a long one is cut short, saying how many lines more, and is whole on the Transcribe page. 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 their place in the order sent (@Image1, @Video1, @Audio1, whatever @name the words called them), 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. In apps that show Vessero’s windows, the window under the create call already follows the job and plays what it made, so call this when the person asks. 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
Request
curl https://vessero.com/api/v1/jobs/video.8f1c2d3e-4b5a-4789-8abc-def012345678 \
  -H "Authorization: Bearer $VESSERO_API_KEY"
Response200 OK
{
  "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.