API reference

Tiny Desk Concert API

Cast up to 5 people into a 15s Tiny Desk style live concert.

Part of the MakeYourViral API — read the overview for authentication, quickstart, errors and rate limits. Other products: ChatGPT Millionaire Meme, Balli Dance, Baby Wow Performer.

Create a task

POSThttps://makeyourviral.com/api/v1/videos/tinydesk

multipart/form-data. The response is 202 Accepted with the task id, the credits charged and your new balance. Render time is roughly 180–225 seconds.

Parameters

Name	Type	Required	Description
`photos`	file[]	Yes	1–5 performer photos, in slot order (lead / keys / sax / back-left / back-right). JPG, PNG, WebP or HEIC, max 10 MB each.
`quality`	string	No (default 480p)	Render quality: `480p` (25 credits) or `720p` (50 credits).

Example request

curl -X POST https://makeyourviral.com/api/v1/videos/tinydesk \
  -H "Authorization: Bearer mv_live_YOUR_KEY" \
  -F "photos=@lead.jpg" \
  -F "photos=@keys.jpg" \
  -F "photos=@sax.jpg" \
  -F "quality=480p"

Poll the task

curl https://makeyourviral.com/api/v1/videos/{task_id} \
  -H "Authorization: Bearer mv_live_YOUR_KEY"

Status moves queued → processing → succeeded / failed. Poll every 5–10 seconds until succeeded.

Result

{
  "id": "5d8e1f2a-3b4c-4d5e-9f0a-1b2c3d4e5f06",
  "product": "tinydesk",
  "status": "succeeded",
  "created_at": 1762000000000,
  "credits_charged": 25,
  "error": null,
  "video": {
    "url": "https://makeyourviral.com/api/v1/videos/5d8e1f2a-…/file",
    "persistent": true
  }
}

video.url is persistent — the finished MP4 is stored on our infrastructure and the link does not expire. Download it without authentication:

curl -o video.mp4 "{video.url}"

If the render fails, status is failed with an error message and the credits are refunded automatically.

Credits

Quality	Credits
480p (default)	25
720p	50

Credits are shared with the web app — top up here. Failed renders are refunded.