Before you start
- Every member of the project can generate speech, whatever their role. The project must be active.
- The project owner’s credit balance must be above zero. See Credits.
Generate speech
1
Open Text to speech
Click Text to speech in the sidebar.
2
Write the script
Type or paste into the editor (“Start typing here or paste any text you want to turn into lifelike speech”). The counter under the script shows how many of the 3,000 characters you have used.
3
Check the voice and settings
The Voice settings tab shows the voice that will read the script, its Expressiveness and the Dictionaries that are on. See Voice settings.
4
Check the estimate
Beside the button, the estimate shows the expected length and cost, for example “about 1 min 40 s” over “about 4 credits”.



5
Generate
Click Generate speech, or press Cmd+Enter (Ctrl+Enter on Windows). The button shows “Generating”, and the audio starts playing in the player at the bottom of the page as it arrives. When it is done, “TTS job created successfully” confirms it and the take appears in History.
Script length
A script can be up to 3,000 characters, spaces and line breaks included. The editor stops accepting text at 3,000, and the counter turns red. For longer text, generate it in parts. The script needs at least one letter (Arabic or Latin) or digit. A script of only symbols or emoji is refused.The length and credit estimate
The estimate is worked out from the words in your script, before anything is generated. Hover over it to see the word count it used.

It is an estimate. The voice, punctuation and numbers change the real length, and you are charged for the real length of the audio. The estimate appears once the script has a letter or a number.
Words your dictionaries change
When dictionaries are on for the script (see Dictionaries), the words they will change are highlighted in the script. A bar under the script says how many, for example “4 changed words”.- Hover over a highlighted word, or move the cursor into it, to see “Read as:” and the reading. Open in dictionary opens that entry so you can change it.
- Click the bar to see the list, “Words your dictionaries change”.
- Hide highlights beside the bar turns the marks off; Show highlights brings them back.




Add a pronunciation from the script
1
Select the word
Select a word or phrase in the script (one line, up to 80 characters). An Add pronunciation button appears next to it. You can also run “Add pronunciation for “word”” from Cmd+K (Ctrl+K on Windows).
2
Say how to read it
In Read as, write how it should sound.
3
Pick the dictionary
Under Dictionary, pick one that is “On for this script”, one of the “Other dictionaries”, or New dictionary and give it a name. A dictionary that was off is turned on for this script.



4
Save
Click Save. “Saved to …” confirms it. If the word was already in that dictionary, the dialog says so first, and saving replaces its reading.
Paragraph view
For a script over 600 characters, a Paragraphs button appears in the footer. It shows the script one paragraph at a time, each with its own estimated length, and the total at the top (“4 paragraphs, about 2 min 10 s”). A paragraph is the text between line breaks. Paragraph view is for reading only. Click a paragraph to go back to the editor with the cursor at its start. Click Paragraphs again to close it.

Drafts
The script you are writing is saved in this browser as you type, one draft per project. Only the text is saved, not the voice or settings.- When you come back to Text to speech and the editor is empty, the draft returns with “Draft restored”. Click Undo to start from an empty script instead (this deletes the draft).
- The draft is cleared when a generation finishes.
- If you open a past job while you have unsaved text, Hamsa asks first (“Opening this job will discard your current text.”). Discard and open drops the draft.
- A draft doesn’t follow you to another browser or computer.


Send text to text to speech
You can bring text in from other parts of Hamsa Media instead of pasting it.
Text from a transcript arrives without times or speaker names, with each speaker’s turn as its own paragraph. Line breaks are cleaned up: no more than one empty line in a row. From an AI doc with unsaved changes, Hamsa asks first (“Leave without saving?”); Leave and read it aloud sends the text and leaves the document.
Text to speech then opens with the text as the script and the default voice. Pick another voice before you generate if you need one.
Text over 3,000 characters
If the text is too long, a dialog says so: “Too long for text to speech. This text has 4,210 characters. Text to speech takes up to 3,000 at a time.”- Use the first 3,000 characters sends the start of the text. The cut falls on the last space or line break near the end, so a word isn’t split.
- Send the selection instead appears when you sent a whole transcript with segments selected, and the selection fits.
- Cancel sends nothing.
When you already have a draft
If Text to speech has a different script you were writing, Hamsa asks before replacing it: “Replace your text to speech script?”. Keep my script cancels; Replace it sends the text. After it arrives, “Replaced your earlier draft” with Undo lets you get your draft back, until you start editing.Use your script in a voice over
Click Use in a voice over in the page header (or run “Use the script in a voice over” from Cmd+K) to open a new voice over with your script in My script mode. A voice over script takes up to 1,000 characters; a longer script gets the same kind of dialog, with Use the first 1,000 characters. See Create a voice over. The button shows when the script has text and the project is active.

Good to know
- Characters count everything in the field, so spaces and line breaks use up the 3,000 too.
- If the balance runs out, Hamsa refuses the generation; the Owner adds credits in Billing.
- If a generation fails, an error message explains why, and your script stays in the editor. Nothing is added to History.
- Switching to another project with unsaved text asks first. Discarding there deletes the draft.
Related
Voice settings
Choose the voice, expressiveness and dictionaries.
History
Play, compare, download and remix takes.
Dictionaries
Manage pronunciation entries.
Transcript editor
Select segments and send them here.