List models and your Library

Both need a workspace API key as Authorization: Bearer sk_live_…, and answer JSON.

Models

GET https://shotz.co/api/v1/models

Answers {"models": […]}, the models a prompt can start. Tools that work on a clip you already have, and talking avatars, aren’t in it. Each model has:

• id: what to send as model when you generate.
• name and maker.
• kind: video, image or audio.
• credits and unit: the price, in credits for each unit. The unit is 5s clip for video, image for images, minute for a voiceover and track for music.
• maxSeconds: the longest it makes, or null.

Your Library

GET https://shotz.co/api/v1/media

Answers {"media": […], "next": …}, the workspace’s files, newest first. Deleted files aren’t included. Each file has:

• id and name.
• kind: video, image or audio.
• source: upload, generated, export or import.
• mime, bytes, width, height and seconds (null where they don’t apply).
• status: uploading, processing, ready or failed.
• created: when it was added.
• url: a download link to the original file that works for at least an hour.

It returns 50 files at a time. Add ?limit= for up to 100.

More files

When there are more, next is a date. Send it back as before to get the next page, for example GET /api/v1/media?before=2026-10-01T09:30:00Z, and keep going until next is null.