Video API
A video API that records your web app
Send the page to start on and what the video should teach. SayScreen records the screen in a real browser, narrates it and edits it, and your code gets the finished MP4, its captions and a thumbnail.
$1 for 7 days, then $49/month
What “video API” can mean
Three kinds of API make videos from code. They differ in where the picture comes from.
What you send
- Template and editing APIs
- A template or a timeline, with your clips, images and text
- Generative video APIs
- A text prompt or an image
- A recording API
- A page address and what the video should teach
Where the picture comes from
- Template and editing APIs
- Your own media, arranged by the template
- Generative video APIs
- An AI model generates the footage
- A recording API
- A real browser working through your app
Good for
- Template and editing APIs
- Personalized promos and social clips in volume
- Generative video APIs
- Ads, b-roll and creative clips
- A recording API
- Tutorials, demos and help videos of software
What SayScreen makes
- Template and editing APIs
- No
- Generative video APIs
- No
- A recording API
- Yes
| Template and editing APIs | Generative video APIs | A recording API | |
|---|---|---|---|
| What you send | A template or a timeline, with your clips, images and text | A text prompt or an image | A page address and what the video should teach |
| Where the picture comes from | Your own media, arranged by the template | An AI model generates the footage | A real browser working through your app |
| Good for | Personalized promos and social clips in volume | Ads, b-roll and creative clips | Tutorials, demos and help videos of software |
| What SayScreen makes | No | No | Yes |
SayScreen's API is the third kind only: every video is a narrated recording of a page you name. To build with it, see the API reference in the help center and real examples of the videos it makes.
From an API call to a finished video
- 1
Create a key
On the API page in your account, name a key and copy it. It goes in the Authorization header of every call.
- 2
Send a page and a prompt
POST the page the video starts on and what it should teach. Add a voice, language, ratio, captions or music if you like; anything you leave out comes from your New video page.
- 3
Get the video
A webhook tells your server when it's done, or you can check on it. Then download the MP4, the .srt captions and the thumbnail with your key.
What the API takes care of
- Hundreds in one call
- Send up to 500 videos as a batch, with the settings they share written once. Every video is checked before any is made, and they can all go into one project.
- Signed webhooks
- Your server hears when a video is done, has failed or was cancelled. Each webhook is signed with your secret, so you can check it came from SayScreen.
- Safe retries
- Add an Idempotency-Key header, and sending the same call again within 24 hours returns the first answer instead of making the video twice.
- Sign-ins that wait
- For pages behind a login, sign in to the site once in SayScreen. If a sign-in is missing or has run out, that site's videos wait instead of failing, and you get a link to sign in.
- Every call on record
- The API page keeps the last 30 days of calls and webhooks, with what was sent and what came back, and can send a webhook again.
- Videos you can still edit
- API videos show up in the app with your others, where you can change the words, the voice or the look, then click Update video.
What it doesn't do
- Generate footage
- There's no stock video, no avatar and no generated scenes. Every video is a recording of the page you name, which is why it suits tutorials and demos.
- Answer in seconds
- A video is recorded, narrated and edited before it comes back, so plan for minutes, not a real-time response. Videos are made one at a time, in the order they came.
- Reach private networks
- The page has to be reachable on the internet. Pages on a private network or behind a VPN can't be reached.
One plan. Start for $1.
$1 for your first 7 days, then $49 a month for 60 minutes of video, up to 8 minutes each. Cancel anytime.
- 60 minutes of video a month, up to 8 minutes each
- Extra minutes whenever you need them, 75¢ each
- 1080p at 60 fps, widescreen or vertical
- Natural AI voices in 94 languages, or your own cloned voice
- 22 backgrounds, 5 of them moving, or your own image
- Background music: 50 tracks, or your own song
- Captions and .srt export
- Recording behind logins
- Videos from screenshots, for desktop and phone apps
- Many videos at once, an API and an MCP server
- Edits and re-renders only use the time they add
- Discovery: video ideas from your own app
- YouTube titles, descriptions and thumbnails
Questions about the video API
An API that makes videos from code instead of in an editor. Some assemble clips and templates, some generate footage from a text prompt, and SayScreen's records a real web app in a browser and returns a narrated, edited tutorial video.
Create a key on the API page, then send a POST to /api/v1/videos with two fields: url, the page the video starts on, and prompt, what it should teach. The answer has the video's id. Check on it or wait for a webhook, then download the MP4 once its status is done.
Yes. One call to /api/v1/batches takes up to 500 videos, and up to 5,000 can wait their turn at once. They're made one at a time, in order, and each starts once your account has the minutes for it.
API videos use your account's minutes, the same as videos made in the app. SayScreen is $1 for your first 7 days, then $49 a month for 60 minutes of video, up to 8 minutes each, and on the plan you can buy more minutes at 75¢ each. A cancelled video uses none.
A title, the voice and its speed, the language, a 16:9 or 9:16 ratio, burned-in captions and their look, music, the longest the video may run, the project it goes into, a webhook address and your own metadata. Anything you leave out comes from your New video page.
Yes. Sign in to the site once in SayScreen, under Settings, and API videos record with that session. If a video comes to a sign-in SayScreen doesn't have, that site's videos wait, and an email, and a webhook if you set one, give you the link to sign in. What you type is never saved or logged, and the AI never signs in for you.
The video as an MP4, its captions as an .srt file and a thumbnail, plus title options and a description ready for YouTube. Each video also says what it was made with, such as its voice, language and ratio.
Yes. SayScreen also has an MCP server, so assistants such as Claude and ChatGPT can make the same videos from a request in the chat.
Keep exploring
Your next tutorial is a few sentences away.
Point SayScreen at your app, say what to teach, and get a narrated, edited video back.
$1 for 7 days, then $49/month · Cancel anytime