Developers

Send a topic, get back a finished vertical video - script, voiceover, footage, captions and music - for YouTube Shorts, TikTok and Reels. Paid from your credits, like a video made in the app.

1. Get a key

API keys come with the Silver plan and up. Make one below, give it a name, and copy it - it's shown once. You can have 5 at a time, and revoke any of them whenever you like. Send it with every request:

Authorization: Bearer tc_live_…

Keep it on your server. Anyone with the key can spend your credits.

2. Make a video

curl -X POST https://tallclip.com/api/v1/videos \
  -H "Authorization: Bearer $TALLCLIP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "Why the Moon is drifting away from Earth", "tone": "Educational", "length": "YouTube Shorts", "visuals": "stock"}'

The answer comes straight back, while the video is made:

HTTP/1.1 202 Accepted
{ "id": "6f1c…", "status": "queued", "credits": 1200, "statusUrl": "/api/v1/videos/6f1c…" }

The whole price is taken when the request is accepted. The voiceover is charged at its most and the difference is given back once the script is written. If the video can't be started, everything is given back; if the render fails, its part is given back automatically.

Moving AI clips aren't offered through the API yet - make those in the app.

3. Check on it

curl https://tallclip.com/api/v1/videos/VIDEO_ID \
  -H "Authorization: Bearer $TALLCLIP_KEY"

{ "id": "6f1c…", "status": "rendering", "progress": 0.42, "stage": "rendering", "credits": 1200, … }
{ "id": "6f1c…", "status": "done", "progress": 1, "videoUrl": "https://…mp4", … }

Ask every 10 to 15 seconds; a one-minute video usually takes a few minutes. GET /api/v1/videos?id=VIDEO_ID works too, and GET /api/v1/videos lists your 20 newest.

Your account

curl https://tallclip.com/api/v1/me -H "Authorization: Bearer $TALLCLIP_KEY"

{ "credits": 52000, "available": 52000, "plan": { "id": "silver", "name": "Silver", "videosPerDay": 2 }, "api": { "allowed": true, … } }

available leaves out credits set aside for scheduled Auto-Pilot posts, which API videos can't spend. In a team, the API spends the team owner's credits, as the app does.

What a video costs

In credits, with a standard voice - the same prices as the app. Taken from your plan's credits or any you've topped up. AI pictures are made on your plan's picture model, so they cost what that model costs.

Credits to pounds: 27,000 credits for £10 at top-up prices, so 1,000 credits is about 37p - a plan's credits work out cheaper. See pricing for plans.

A premium voice adds to the voiceover part: at YouTube Shorts length it's 540 credits on Silver and 1,100 from Gold up, against 340 for a standard voice. These are the most a video is charged; the voiceover's share usually comes in a little under and the rest is given back.

Limits

Past a limit you get 429 with a Retry-After header saying how many seconds to wait.

Errors

Every error has the same shape: { "error": { "code": "…", "message": "…" } }. The message is written to be shown to a person.

Make a Short from any page

Reading an article you want to turn into a video? Drag this to your bookmarks bar, then click it on any page - TallClip opens with that page ready under From a link. Nothing is charged until you press the button there.

Or add a bookmark by hand with this as its address:

javascript:(function(){window.open('https://tallclip.com/create?link='+encodeURIComponent(location.href),'_blank');})();

Chrome extension

The same thing as a button in Chrome's toolbar. It only sees the page you click it on, and only when you click it. To try it before it's in the Chrome Web Store: download it, unzip it, open chrome://extensions, switch on Developer mode, choose Load unpacked and pick the unzipped folder.