Made in 10Docs
GuidesAPI
Getting started

Make a character

Four ways to make a character, from the dashboard, a starter kit, the builder or the API, and what to do next.

A character is a name, instructions, what it knows, a face (or none) and a voice. Make your first one whichever way suits you; they all make the same thing, and you can change any of it later.

In the dashboard

  • Talk to Alex. On the dashboard's Home, Alex, one of our characters, builds yours with you on a live call, or typed if you'd rather (or type instead). She asks what it's for, who it talks to and in which language, proposes a name and a face, and asks before she makes anything. See the builder.
  • Start from a kit. Starter kits has ready-made characters: support, a receptionist, sales, an interviewer, an onboarding guide, a language partner, and Persian and Arabic assistants. See starter kits.
  • From scratch. Characters → New: a role, a face, a name, then its instructions and greeting.

Talking to a character from the dashboard is a real call, charged like any other.

Through the API

With a secret key (a test key, sk_test_…, to try things first; see authentication):

Create a character
curl https://talk.madein10.com/v1/characters \
  -H "Authorization: Bearer $ACME_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sara",
    "role": "support",
    "language": "auto",
    "greeting": "Hi, I'\''m Sara, an AI assistant. How can I help?",
    "instructions": "You answer questions about our opening hours and bookings."
  }'

Only name is required. A role with no words of its own starts from that role's template. face_id takes one of the faces in the catalog (null for voice only); voice_id null speaks with the face's own voice. Every field is on the character page, and every call on Create a character.

To start from a kit instead: POST /v1/starter-kits/{kit_id}/use, with the kit's id (support, receptionist, sales…) and, if you like, another name, face_id, voice_id or language. See Make a character from a starter kit.

With your AI assistant

Connect our MCP server to Claude Code, Claude Desktop or Cursor with a secret key, and ask: "Make me a receptionist that greets in Persian and English." The assistant lists the starter kits, makes the character and asks you for the facts it should know.

What to do next

On this page