Skip to content
Get your keyGet a key

Reference · Library

GET/work

Recent work from one studio

The person's recent work in one studio, newest first, as that studio's page lists it: what each piece is, whether it is ready, still being made (with its stage), failed, or waiting for a yes (a UGC ad made step by step, its preview ready and its video not made yet), links to the finished files and to what waits (good for about 7 days), and what it was charged. Use it for "my last video", "the track I made yesterday", or to find the job of something still being made. Each finished piece carries useAs, which POST /api/v1/library/use takes to put it into a create tool (animate a picture, upscale a clip, use a track). Videos, pictures, talking avatars, influencer clips, UGC ads and picture ads also list what each was made from (madeFrom), as its page shows: 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), the video it carried on or edited, a UGC ad’s presenters and product (@Presenter1, @Product1), a picture ad’s product and model, and an upscale’s picture as it went in, each with a link. Studios: video, images, voice, music, avatars, enhance, captions, transcribe (transcripts: their words come back from GET /api/v1/jobs/{jobId}, kind "transcript"), ugc, picture-ads, influencer, story. For everything at once, across studios and boards, use GET /api/v1/library. Free.

Key needs
account:read · See your account
Spends
Nothing
Answers
Data
Request
curl https://vessero.com/api/v1/work \
  -H "Authorization: Bearer $VESSERO_API_KEY"
Response200 OK
{
  "studio": "video",
  "items": [
    {
      "id": "8f1c2d3e-4b5a-4789-8abc-def012345678",
      "job": {
        "kind": "video",
        "id": "video.8f1c2d3e-4b5a-4789-8abc-def012345678",
        "url": "/api/v1/jobs/video.8f1c2d3e-4b5a-4789-8abc-def012345678"
      },
      "status": "working",
      "stage": "Rendering",
      "prompt": "A linen shirt on a hanger by a sunny window, the camera slowly pushing in",
      "model": "Seedance 2.0",
      "files": [],
      "durationSec": 5,
      "createdAt": "2026-11-08T09:12:00.000Z",
      "useAs": null
    }
  ]
}

Query

  • studiostringrequiredWhich studio, e.g. "video": video, images, voice, music, avatars, enhance, captions, transcribe, ugc, picture-ads, influencer or story.videoimagesvoicemusicavatarsenhancecaptionstranscribeugcpicture-adsinfluencerstory
  • limitintegerHow many of the newest pieces, 1–50. Default 10.

Answers

  • 200okThe answer, as data.
  • 404not_foundNot found on this account.
  • 429rate_limitedToo many calls this minute: see Retry-After.
Next in LibraryGET/cast