Skip to content
Log in
Developer API
Get your keyGet a key

Reference · Library

POST/library/use

A storage key for a Library piece, to pass to a create

Turn a picture, video or sound the person already has — something they made, a file they uploaded, a cast member's or a product's picture — into the storage key a create tool takes for its inputs (a reference picture, a start frame, a video to edit or follow, a voice or sound). It copies the file into their uploads, held to what the slot takes (a picture as a picture; a video or sound made into a file the models read), and answers the key, its kind, and for a video or sound its length. Free.

Key needs
create · Make things and spend credits
Spends
Nothing
Answers
Data
Request
curl -X POST https://vessero.com/api/v1/library/use \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "kind": "library",
      "source": "studio",
      "id": "text"
    },
    "as": "image"
  }'

Body

  • fromobject · kind library | upload | cast | productrequiredWhat to use: {kind: "library", source, id} for a piece they made (the useAs of GET /api/v1/library or GET /api/v1/work), {kind: "upload", id} for a file they uploaded, {kind: "cast", id, pose?} or {kind: "product", id, imageKey?} for a picture of a cast member or a product.
  • asstringrequiredWhat the create tool will use it as: image (a picture), video, or audio (a voice or sound). A cast member or a product gives an image.imagevideoaudio

Answers

  • 200okWhat it did, as data.
  • 400invalid_requestA field is missing or not accepted: see details.
  • 404not_foundNot found on this account.
  • 403feature_unavailableThe studio this needs is switched off for the account right now.
Next in LibraryGET/work