Reads a text aloud in a natural Portuguese voice from Fish Audio — Rafael by default, or one of six others — and returns an MP3.
WHEN TO USE: the user wants to hear a Portuguese text or needs an audio file of it — narration, audiobook, lesson, voice-over, a message read aloud. The voices speak Portuguese (Brazil, and Tomás from Portugal); a text in another language is read with their accent.
HOW IT WORKS:
- Up to 50,000 characters per call. A text over 1,000 characters is split by sentence into parts of up to 1,000; the parts are voiced three at a time and joined in order into ONE MP3. Progress is reported per part ("Gerando áudio... 3 de 18"), so keep waiting while it arrives.
- It takes time: about 25 seconds per round of three parts. 1,000 characters ≈ 25 s; 5,000 ≈ 1 min; 16,000 ≈ 2.5 min; 50,000 ≈ 7 min.
- Over 50,000 characters: split the text at paragraph boundaries into several calls with the same voice and speed, and give the user every link, in order.
- Send the text as it should be HEARD: remove Markdown marks (**, #, list bullets), URLs, emojis and tables. Do not summarize, translate or reword unless the user asked — every word you send is read.
- voice: rafael (default) or beatriz for clear, neutral narration; tomas for European Portuguese; narrador-propagandas for ads; rodolfo, sao-cipriano and capitao-nascimento are deep character voices.
- speed: 1 is the voice's natural pace; 0.9 suits calm narration, 1.2 a quick read.
RETURNS:
- audioUrl: the complete MP3 to download, valid for 7 days. Always give this link to the user. If you can run commands, you can download it (e.g. curl -o audio.mp3 <audioUrl>).
- audio: the MP3 itself, only when it is short (about a minute or less); otherwise null.
- seconds (duration), parts, characters, voice, speed.
- link: this tool's web page with the same voice and speed (the text is not in it).
ERRORS say what happened and what to do next. If a part fails, no audio is produced and a new call starts again from part 1.