# Text-to-Video Explainers

Articles, show notes, and help content become narrated explainer clips in your brand voice.

Text-to-Video Explainers turn written content into short narrated videos. Studio reads the text, narrates it in your brand voice, and builds the visuals in the style you set. Each explainer waits in Drafts until you approve it.

[Octo](https://begenuin.com/developers/get-started/any-business/octo-operates-your-brand-control-center-octo-proposes-you-approve), Genuin's Supervised Intelligence interface in Brand Control Center (BCC), proposes this capability when it finds a fit on your sites and apps. It completes the steps under Set it up from your brand context. Nothing goes live until you approve it. It's part of [Studio](https://begenuin.com/developers/browse-by-products/studio/studio-what-it-does-and-where-to-start), and [Studio: produce brand video from podcasts, long-form, and catalogs](https://begenuin.com/developers/get-started/any-business/studio-produce-brand-video-from-podcasts-long-form-and-catalogs) explains how text sits beside Studio's other inputs.

## When to use it

Use it when much of your best content is written rather than recorded. It fits publishers, help centers, and B2B sites.

| Site | Text to start from | Player that fits |
| --- | --- | --- |
| Publisher | Articles and show notes | [Vertical Video Player Placement](https://begenuin.com/developers/browse-by-products/onsite/vertical-video-player-placement) on article pages |
| Help center | Help articles | [Horizontal Video Player Placement](https://begenuin.com/developers/browse-by-products/onsite/horizontal-video-player-placement) in the article body |
| B2B site | Articles and help content | A horizontal player on product demo pages |

If you have recorded webinars or demos as well, [Clip Generation from Long-form](https://begenuin.com/developers/browse-by-products/studio/clip-generation-from-long-form) cuts those into clips.

## How it works

- You connect a text source, or paste text straight into Studio.
- Studio turns the text into a narrated explainer clip, in the voice, length, and visual style you set.
- Each clip gets a title, a caption, and topic tags in your brand voice. Brand guidelines you upload under **Brand** > **Context** shape them too.
- Studio proposes a group and placements by context match. It runs the brand safety baseline and flags anything that needs a human.
- Your edits in Drafts train Studio, and after a few dozen approvals most drafts need no edits.
- For a 16:9 player, [Adaptation](https://begenuin.com/developers/browse-by-products/studio/adaptation) re-cuts vertical clips to landscape automatically.

## Set it up

Octo proposes explainers with these steps already done. You review the result and confirm it.

1. Connect a text source, or paste text in Studio.
2. Choose **Generate explainer**.
3. Approve the explainer in **Studio** > **Drafts**. Learn how your edits shape later drafts in [Captions, Titles, and Brand Voice](https://begenuin.com/developers/browse-by-products/studio/captions-titles-and-brand-voice).

## Settings

| Setting | What it controls |
| --- | --- |
| Voice | The voice and tone of the narration |
| Length | How long each explainer runs |
| Visual style | How the explainer looks on screen |

Octo fills these from your brand context, and you change them when you review the proposal. The voice starts from your brand kit, where you pick plain, warm, expert, or playful in [Set your brand identity: name, logo, colors, and voice](https://begenuin.com/developers/get-started/any-business/set-brand-identity).

## What it reports

- **Engagement by source article**: how viewers engage with the explainers made from each article.

Engagement here means watch time per user per minute, with lift against a holdout and completion alongside it.

**Reports** > **Engagement** filters these by content source. [Measure engagement: watch time, lift, and cohorts](https://begenuin.com/developers/get-started/any-business/measure-engagement-watch-time-lift-and-cohorts) explains how each measure is counted.

## Connect your systems

The live API covers the communities, groups, and posts your explainers land in.

- [Create a community](https://begenuin.com/developers/developer-resources/api/create-a-community-programmatically-using-community-api) creates a community under your brand, with its type, access settings, and first members.
- [Create a group in a community](https://begenuin.com/developers/developer-resources/api/create-a-group-programmatically-within-community-using-create-group-api) adds a group with its visibility and posting rules.
- [Post a video to a group](https://begenuin.com/developers/developer-resources/api/post-and-share-a-video-within-a-group-using-the-post-video-api) uploads a video and its thumbnail, then posts it to a group with a caption.

The Studio calls in the [Business Account API](https://begenuin.com/developers/get-started/any-business/business-account-api-provisioning-oauth-and-the-resource-map) are proposed, not live. [Live API today and the Business Account API roadmap](https://begenuin.com/developers/developer-resources/guides/live-api-today-and-the-business-account-api-roadmap) maps what you can call now to what's planned.