Made in 10Docs
GuidesAPI
Characters

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.

A face
{
  "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
}
  • id is what a character's face_id takes. voice_id is the voice it speaks with by default, and character_name the name it goes by.
  • look says how it looks in a sentence; tags are words to find it by. idle is a short video of it sitting still.
  • picture, thumb and idle are 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.

A voice
{
  "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"
}
  • id is what a character's voice_id takes; face_id is the face it comes with.
  • languages are the one it speaks natively and English. Every voice also speaks the catalog's other languages, less natively.
  • preview_url plays 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 setThe 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: nullVoice only: no face
voice_id: nullBack 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 favouritesGET /v1/favourites answers { "faces": [...], "voices": [...] }
Star onePUT /v1/favourites/faces/{id} or /voices/{id}; starring twice is fine
Unstar oneDELETE 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.

On this page