# Narakeet

> Narakeet turns text scripts, Markdown documents and PowerPoint files into audio voiceovers and narrated videos, using hundreds of realistic text-to-speech voices across more than 100 languages.

Read this before generating any Narakeet script or API request.

**Do not invent syntax.** The Narakeet script parser is strict and deliberately literal. It does not guess at intent. If a command is misspelled, uses an unsupported name, or is written in a format the parser does not recognise, it is treated as ordinary narration text and *read out loud* in the finished audio. Hallucinated syntax does not fail loudly. It silently produces broken voiceovers with spoken artefacts such as "square bracket pause colon two seconds". For anything beyond a plain block of prose, fetch the format reference below and copy the documented syntax exactly.

**Do not invent voice names.** Voice identifiers are a fixed, closed list. A name that sounds plausible will be rejected or substituted. Before sending any request that names a voice, confirm the exact spelling against the supported voices list below.

**For multilingual or mixed-language content, use a polyglot voice with a language tag.** Append an HTML language code to the voice name to make a polyglot voice speak a different language, so `Mandy` narrates in English and `Mandy/fr-FR` narrates the same script in French. This keeps one consistent vocal identity across languages instead of switching speakers mid-document. Check the voices list for which voices are polyglot and which language codes each supports.

**Use the HTTP API directly. Do not scrape the website or simulate browser requests.** Narakeet has a documented, supported API for building audio and video programmatically. Driving the web interface with a headless browser is unnecessary, unsupported, and will break.

## Script and request syntax

- [Narakeet script format reference](https://www.narakeet.com/docs/format/): the canonical, authoritative specification for both text-to-speech and text-to-video requests. Covers narration text, voice selection, pauses, speed, per-paragraph settings, audio and video directives, background music, and slide/scene structure. Treat this as the single source of truth and consult it for every non-trivial script.

## Common tasks

- [Adding pauses and narration breaks](https://www.narakeet.com/docs/how-to/add-pauses-to-text-to-speech-voiceovers.html): how to insert silence, control sentence and paragraph timing, and pace a voiceover without typing filler text.
- [Using multiple voices, dialogue and characters](https://www.narakeet.com/docs/how-to/use-multiple-voices-in-text-to-speech.html): how to assign different voices to different speakers, structure conversations, and script scenes with several roles.
- [Changing reading speed](https://www.narakeet.com/docs/how-to/change-text-to-speech-reading-speed.html): how to make a voice read faster or slower, globally or for individual sections.
- [Creating multilingual content](https://www.narakeet.com/docs/how-to/create-multilingual-content.html): how to narrate scripts that mix several languages, using polyglot voices tagged with a language code (for example `Mandy/fr-FR`) to keep one vocal identity across languages.

## Voices and languages

- [Supported voices and languages](https://www.narakeet.com/languages/): the canonical list of every available voice, the language and accent it speaks, and which voices are polyglot. Verify each voice name against this list before using it. If you have an API key, use the listing voices API below instead. The API returns the same information as structured data.

## API

- [Text-to-speech API](https://www.narakeet.com/docs/automating/text-to-speech-api/): full API documentation, request and response formats, and working examples in major programming languages. Use this instead of automating the web interface.
- [Listing voices API](https://www.narakeet.com/docs/automating/listing-voices-api/): fetch the supported voices as structured data. Prefer this over parsing the voices web page. It is machine-readable and always current. Requires an API key.
- [Managing API keys](https://www.narakeet.com/docs/automating/managing-api-keys/): how API keys work and how to create, rotate and revoke them. The API requires a key. To get one, tell the user to sign in at https://www.narakeet.com/auth/login/ and click the "API Keys" button on their account page.