chitrio

Screen recording to video API

Turn screen recordings into narrated tutorial videos through an API

Product teams record their screen all the time and rarely have time to narrate and edit the result. The Chitrio API takes the raw recording and does that part. Upload an MP4, MOV, WebM or M4V of up to 100 MB to POST /api/v1/recordings; it is split into scene length segments and each segment is transcribed. Then call POST /api/v1/videos/from-recording with a brief and, ideally, timed notes such as "at 2 seconds, open the Products page". Chitrio writes a narration that follows the footage in order, voices it, adds captions and renders the tutorial. Whatever was said on screen is folded into each segment automatically. The finished video arrives the same way as any other job: a signed webhook or the status endpoint.

Create a workspace and a key Read the API reference

Free trial to start · the cost is shown before every render

Straight answer: The footage plays in order and is not re-shot or redrawn. A silent recording needs notes or clip descriptions, otherwise the narration can only be generic. Uploaded recordings are kept for 72 hours.

How it works

  1. 1

    Upload the recording

    POST /api/v1/recordings as multipart with the file and an optional sceneSeconds from 12 to 60. You get a recordingId and the transcribed segments.

  2. 2

    Describe what happens

    Send a topic plus timed notes, or one description per segment, to POST /api/v1/videos/from-recording.

  3. 3

    Publish the tutorial

    Collect the narrated MP4 with captions, and an optional vertical Short, from the webhook or the status call.

The API call

Real endpoints and fields. The full reference, with Node.js and Python examples, is on the developers page.

Step 1: upload

curl -X POST https://chitrio.com/api/v1/recordings \
  -H "X-Api-Key: YOUR_API_KEY" -F file=@walkthrough.mp4 -F sceneSeconds=25

HTTP/1.1 201 Created
{ "recordingId": "b7d0e6c2a4f94d3b9a1e0c5d7f2a8b61", "expiresAtUtc": "2026-11-14T10:12:44Z",
  "segments": [ { "index": 0, "start": 0, "duration": 25, "transcript": "So first we open the products page" },
                { "index": 1, "start": 25, "duration": 21.4, "transcript": null } ] }

Step 2: narrate

curl -X POST https://chitrio.com/api/v1/videos/from-recording \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"recordingId":"b7d0e6c2a4f94d3b9a1e0c5d7f2a8b61","topic":"How to add a product",
       "notes":[{"t":2,"text":"Open the Products page"},{"t":30,"text":"Fill in the price and save"}]}'

HTTP/1.1 202 Accepted
{ "jobId": "3f1c9a0e-...", "status": "Processing", "title": "How to Add a Product", "scenes": 2 }

Chitrio features used

Named as they appear in the product, so you can find each one after you sign in.

  • The API: video inside any product

    An LMS, a CRM or an HR platform sends a topic and gets a finished video back.

  • Shorts from every video

    Make a Short from one idea, or get a vertical Short and free Status cuts from every finished video.

What people make with it

SaaS help centres

Every new feature recording becomes a narrated how to video for your docs without a voice actor or an editor.

Release notes

Record the change, add three notes, and ship a short narrated video with the release.

Onboarding flows

Turn internal walkthroughs into clear onboarding videos for new customers or new staff.

Training in other languages

Narrate the same recording in Hindi, Spanish or another render language by changing the language field.

Questions, answered

Which files can I upload?

MP4, MOV, WebM or M4V of up to 100 MB. Larger files answer 413; trim or re-encode them first.

Do I have to write the narration?

No. You give a brief and short notes about what happens; Chitrio writes and voices a narration that follows the footage.

What if my recording has no sound?

That works. Add timed notes or one description per segment so the narration knows what each part shows.

How long is a recording kept?

For 72 hours after upload. After that a create call answers 410 and the file has to be uploaded again. Finished videos are not affected.

Can the tutorial be in Hindi?

Yes. Pass language "hi" or another render language and the narration and captions come out in it.

Related pages

AI Video Generation API: Topic to MP4 Text to Video API for Developers Screen Recording to Tutorial Video With AI Hindi Text to Video API, Indian Languages All video tools

Narrate your first recording

Create a key, upload a short screen recording and send two notes. The full flow is on the developers page.

Create a workspace and a key