Media and presets

Uploading mediaCopy Anchor Link

Uploads are two calls around a direct upload to storage:

UP=$(curl -s -X POST -H "Authorization: Bearer $VST" -H 'Content-Type: application/json' \
  -d '{"mimeType":"image/png"}' $API/workspaces/$WS/media/upload-url)
curl -s -X PUT -H 'Content-Type: image/png' --data-binary @photo.png "$(echo $UP | jq -r .data.uploadUrl)"
curl -s -X POST -H "Authorization: Bearer $VST" -H 'Content-Type: application/json' \
  -d "{\"path\":\"$(echo $UP | jq -r .data.path)\"}" $API/workspaces/$WS/media/complete

Reference images for generations/image must be Studio media URLs, so upload external images first.

PresetsCopy Anchor Link

GET /presets lists the available presets: UGC styles (selfie review, unboxing, lifestyle), product hero shots and short-video storyboards.

POST generations/preset with { "presetId", "subject", "campaignId"? } generates the images into your media library (and the campaign, if given) together with caption copy.

Note. Video presets produce a 9:16 storyboard (keyframes plus a voiceover script). Studio does not render video files yet.