Projects and members
A project is the shared space your team works in. Transcripts, text to speech history, voice overs, AI docs, web reader sites, custom voices, dictionaries, members and API keys all live in a project. Switch projects in the header and you see a different set. Projects are the same in Hamsa Media and Hamsa Agents: a project made in one app appears in the other, with the same members and roles. Each member is an Owner, Admin or User. See Projects and Team members. Some work in a project is personal. Other members don’t see it in their lists:- your text to speech history,
- your voice overs,
- the web reader sites you added,
- your favorite voices and your project defaults (kept in your browser).
Jobs and statuses
Most things you start in Hamsa Media run as a job in the background: a transcript, a speech take, an AI doc, a voice over and its videos. You can start one, move on, and come back. The Activity tray in the header follows every job while it runs, and Recent work on Home shows the newest ones.

Voice overs use their own words: Generating, Ready (prompt options waiting for you to pick one), Generating video and Failed. Text to speech keeps only finished takes; a generation that fails leaves nothing in History.
A failed transcript, speech take or voice over video can run again with Try again in the Activity tray, and a transcript from its row menu too. A failed AI doc or voice over is made again from its own page. See Run a failed job again.
Credits
Every service is paid for in credits. Credits, the plan and the balance belong to the project Owner’s account, not to a project: every project that Owner has, in Hamsa Media and Hamsa Agents, spends from the same balance.
Playing, comparing, exporting and downloading cost nothing. Failed jobs aren’t charged.
- They last twelve months. Every batch of credits, from your plan, a top-up or your sign-up gift, can be used for twelve months from the day it arrives. The batch that expires soonest is spent first.
- You need a balance above zero to start. With none, a new job is refused and the Insufficient credits dialog offers to upgrade or buy credits. A job that has started finishes, so a long one can take the balance below zero.
- Your plan can cap use. Some plans limit how many transcriptions you start a month and how many speech takes you make a day, and the web reader needs Pro or higher.


Voices
A voice reads your text in text to speech, voice overs and the web reader. Each voice speaks one language, and each Arabic voice speaks one dialect.
A project voice is cloned from 3 to 20 seconds of clear speech. Owners and Admins add and delete them by default.


Dictionaries
A pronunciation dictionary is a list of words (the source) and how each should be said (the correction). Before a script is read, Hamsa swaps each source for its correction; your text stays as you wrote it.- Dictionaries belong to the project, and the same dictionaries work in Hamsa Agents.
- You turn them on per script in text to speech (up to 10), set them in project defaults, give them to a web reader site, or turn them on for an agent.
- Add pronunciation on a word in a transcript or a script saves an entry without leaving the page.
- Voice overs don’t use dictionaries.


Languages and dialects
Arabic dialects include Saudi Arabia, Arabic (Gulf), UAE, Kuwait, Qatar, Bahrain, Oman, Iraq, Jordan, Palestine, Syria, Lebanon, Egypt and MSA (Modern Standard Arabic). Arabic text reads right to left in transcripts, documents and exports. The app itself is in English or العربية; switch in the account menu.
Permissions
Roles and permissions belong to the project, so they are the same in both apps.
The services themselves have no permission switches: every member can always use them. The Owner can turn single permissions on or off for one member, for example Create on Voices to let a User add voices and dictionaries. Hamsa Media shows every button to every member: when you lack a permission, the action is refused with a message rather than hidden. See Roles and permissions.
API keys have their own scopes, separate from member permissions. See API keys.
Related
Quickstart
Transcribe a file, then turn it into speech.
Limits
Every number you can run into.
Troubleshooting
Common problems and how to fix them.
Billing
Plans, credits and how they expire.