Text to video API

A text to video API: send a brief, receive a narrated MP4

The input is text. It can be a short topic like "Espresso, explained" or a full brief with the angle, the audience and the length you want ("a 60 second explainer for first time investors"). Chitrio reads the brief, writes a scene by scene script, voices it, makes a moving visual for every scene in the style you choose (realistic, stylised 3D, anime, storybook, comic or pixel art), adds word level captions and music, and renders the file. Tone is a parameter too: cinematic, educational, conversational, energetic, documentary, storytelling or inspirational. You do not stitch anything together. The call returns a jobId within seconds, and the finished video arrives through a signed webhook or the status endpoint.

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

Straight answer: The API writes the script from your text; it does not take a finished script line by line. If wording matters, put it in the brief, and a length written in the brief is honoured. Check facts in anything you publish.

How it works

  1. 1

    Write the brief

    A topic or a paragraph. Add the length, audience or angle in plain words; durationInMinutes sets the target from 1 to 20 minutes.

  2. 2

    Choose the look and voice

    Pass visualStyle and tone per call. The narrator voice, caption style and brand colour come from the workspace settings.

  3. 3

    Render and collect

    POST /api/v1/videos, then take the MP4 from the webhook or the status call. Add generateShort for a vertical cut.

The API call

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

Request: text in

curl -X POST https://chitrio.com/api/v1/videos \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"topic":"A 60 second explainer on compound interest for first time investors","language":"en","tone":"educational","visualStyle":"storybook","generateShort":true}'

Response

HTTP/1.1 202 Accepted
{ "jobId": "3f1c9a0e-...", "status": "Processing", "title": "Compound Interest, Explained in 60 Seconds" }

Download the files

curl -L https://chitrio.com/api/v1/videos/3f1c9a0e-.../download -H "X-Api-Key: YOUR_API_KEY" -o video.mp4
curl -L "https://chitrio.com/api/v1/videos/3f1c9a0e-.../download?variant=short" -H "X-Api-Key: YOUR_API_KEY" -o short.mp4

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

Blog post to video

Send the post title and summary as the brief and publish the video next to the article.

Product explainers

One brief per product or feature, rendered in the same style so a catalogue of videos looks consistent.

News and fact formats

Turn a short written item into a narrated video with captions for viewers who watch on mute.

Lessons and training

Educational tone, a clear structure and captions, generated from a few lines of lesson notes.

Questions, answered

How much text can I send?

Anything from a few words to a detailed brief. The script is written from it, and the length is set by durationInMinutes or by a length written in the brief.

Can I pick the visual style per video?

Yes. visualStyle accepts realistic, pixar3d, anime, storybook, comic and pixelart, and tone accepts seven narration tones.

Do the scenes move?

Yes. Every scene is animated with AI motion by default; there is nothing to configure.

Can I see the cost before rendering?

Yes. GET /api/v1/estimate prices a video for a given length, language, style and Short, without writing a script or spending anything.

What happens if a render fails?

The job ends as Failed with a readable error, a video.failed webhook is sent, and the credits taken for it are returned automatically.

Related pages

Turn your first brief into a video

Create a key under Settings and send one POST. Examples in curl, Node.js and Python are on the developers page.

Create a workspace and a key