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 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
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.