Faces and voices
Our faces and voices, how to pick them for a character, the languages they speak, and your organization's favourites.
A character shows one of our faces, or none, and speaks with a voice. You pick both from the catalog. Every face comes with its own voice, so a face alone is enough; set a voice only to change it.
The catalog
Get the catalog answers what a character can be made of: our faces as they are available now, the voices, the tiers on offer and their prices, the role templates, the languages, and guardrail sets to start from. The dashboard's Faces and Voices pages show the same.
{
"id": "red-office",
"name": "Red hair, office (ours)",
"voice_id": "r1KmysJdVYZjJCm4mL3b",
"character_name": "Alex",
"pronoun": "she",
"gender": "female",
"look": "a woman with long copper-red hair and green eyes, in her twenties",
"accent": "American",
"tags": ["woman", "20s"],
"picture": "https://talk.madein10.com/characters/red-office.jpg",
"thumb": "https://talk.madein10.com/characters/red-office-thumb.jpg",
"idle": "…",
"favourite": false
}idis what a character'sface_idtakes.voice_idis the voice it speaks with by default, andcharacter_namethe name it goes by.looksays how it looks in a sentence;tagsare words to find it by.idleis a short video of it sitting still.picture,thumbandidleare null where we don't have the file yet.- Our portraits all sit in the same quiet, plain room.
When the faces can't be reached for a moment, the catalog answers the last faces it had. Only if they haven't been reachable at all since our service started is faces empty and engine_available false; try again shortly.
{
"id": "C2wYIMnQQbFDm3qaosBN",
"name": "Shirin",
"description": "Soft, young native Persian voice that also speaks fluent English. Suits gentle, friendly calls.",
"gender": "female",
"accent": "Native Persian",
"language": "fa",
"languages": ["fa", "en"],
"tags": ["soft", "young", "persian"],
"face_id": "woman-30s-persian",
"preview_url": "/api/voices/C2wYIMnQQbFDm3qaosBN/preview",
"favourite": false,
"kind": "system"
}idis what a character'svoice_idtakes;face_idis the face it comes with.languagesare the one it speaks natively and English. Every voice also speaks the catalog's other languages, less natively.preview_urlplays a sample of the voice in the dashboard, where you're signed in; it isn't fetched with a secret key. It's null while there's no sample.
Your organization's cloned voices that are ready appear in the catalog's voices too, after ours, with kind: "yours" (ours are kind: "system"). Theirs also carry clone_id (the cloned voice's own id), labels and created_unix; their face_id and preview_url are null, and gender and accent come from your labels (language too when it names one of the catalog's languages; else en).
Pick them for a character
Set face_id and, if you want another voice than the face's, voice_id:
| You set | The character |
|---|---|
face_id: "red-office" | Shows that face and speaks with its voice |
face_id: "red-office", voice_id: "C2wY…" | Shows that face and speaks with that voice |
face_id: null | Voice only: no face |
voice_id: null | Back to the face's own voice |
face_id must be one of the catalog's faces. On one of our faces the character keeps your name and instructions: the face only lends its look.
curl -X PATCH https://talk.madein10.com/v1/characters/chr_4fT9kQ2mXw7LbN3pZs8V \
-H "Authorization: Bearer $SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{ "face_id": "red-office", "voice_id": null }'A face of your own
Owners and admins can ask us for a custom face on the dashboard's Faces page, with a description and a reference link if you have one. We move the request along (requested, in_progress, ready or declined), and each move sends a request.updated webhook. When the request has a fee, it's held when you ask, charged when the face is ready and released if we decline.
Favourites
Star the faces and voices you use most. Favourites are the organization's, shared by everyone in it, and show in the catalog as favourite: true.
| List favourites | GET /v1/favourites answers { "faces": [...], "voices": [...] } |
| Star one | PUT /v1/favourites/faces/{id} or /voices/{id}; starring twice is fine |
| Unstar one | DELETE on the same path |
Only our faces and voices can be starred; another id is 404, and so is a cloned voice. A face or voice we no longer offer can't be unstarred either (404), though it stays in your list of favourites.
From your AI assistant
With our MCP server, an assistant picks faces and voices with list_faces and list_voices, then sets them with update_character.