FreeTTS

List FreeTTS voices for a language or a search word, with the voice id to pass to text_to_speech. Says which voices are free and which need a FreeTTS PRO key (HD and Signature). Use it when the user names a language, accent or gender, or asks what voices exist.

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "description": "Language or locale, like 'German', 'de-DE', 'Spanish (Mexico)' or 'en'. Empty lists every language."
    },
    "search": {
      "type": "string",
      "description": "A word to match in the voice name or personality, like 'Andrew', 'calm' or 'news'."
    },
    "gender": {
      "type": "string",
      "enum": [
        "female",
        "male",
        "any"
      ],
      "description": "Filter by gender."
    },
    "free_only": {
      "type": "boolean",
      "description": "Only voices that work without a FreeTTS key."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "How many to return. Default 15."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Suggest three FreeTTS voices for a language and a use (audiobook, tutorial, ad, news, children's story, meditation, podcast), with a short reason each. Use it when the user has not named a voice.

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "description": "Language or locale, like 'English (US)', 'de-DE' or 'Portuguese (Brazil)'."
    },
    "use": {
      "type": "string",
      "description": "What the audio is for, in a few words."
    },
    "gender": {
      "type": "string",
      "enum": [
        "female",
        "male",
        "any"
      ]
    }
  },
  "required": [
    "language"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Convert text to spoken audio with a FreeTTS voice and return a download link to the MP3 (or WAV with a FreeTTS PRO key). Use it when the user wants text read aloud, narrated, or saved as an audio file. Without a FreeTTS key: standard voices, up to 2,000 characters a call, a short spoken "FreeTTS" tag at the end, file kept one hour. With a key: the account's plan (PRO: HD and Signature voices, no tag, 10,000 characters a call, files kept 30 days).

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30000,
      "description": "The text to read. Plain text; SSML is not needed."
    },
    "voice": {
      "type": "string",
      "description": "A FreeTTS voice id from list_voices, like en-US-JennyNeural (a short name like 'Jenny' also works). If empty, a good standard voice for the language is chosen."
    },
    "language": {
      "type": "string",
      "description": "Language of the text when no voice is given, like 'German' or 'pt-BR'."
    },
    "speed": {
      "type": "integer",
      "minimum": -30,
      "maximum": 30,
      "description": "Percent slower (negative) or faster (positive). Default 0."
    },
    "format": {
      "type": "string",
      "enum": [
        "mp3",
        "wav"
      ],
      "description": "mp3 (default) or wav (FreeTTS PRO)."
    },
    "include_audio": {
      "type": "boolean",
      "description": "Also return the audio bytes in the result (large). Default false; the link is enough for most clients."
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Show the FreeTTS plan behind this connection and what is left: characters today or this month, requests a minute, HD voices, watermark. Use it when the user asks about limits, their plan, or why a request was refused.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Turn a script with several speakers into one audio file, a different FreeTTS voice per speaker, with a pause between lines. Write each line as 'Name: text'. Use it for two-host shows, interviews, scenes, language lessons with two speakers. Needs a connected FreeTTS PRO account.

{
  "type": "object",
  "properties": {
    "script": {
      "type": "string",
      "minLength": 1,
      "maxLength": 25000,
      "description": "Lines like 'Abd: Tonight we cook shakshuka.' one per line. Names before the colon."
    },
    "voices": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Speaker name to FreeTTS voice id, like {\"Abd\": \"en-US-AndrewNeural\", \"Guest\": \"en-US-EmmaNeural\"}. Unnamed speakers get a voice each."
    },
    "pause_ms": {
      "type": "integer",
      "minimum": 0,
      "maximum": 5000,
      "description": "Silence between lines in milliseconds. Default 600."
    },
    "language": {
      "type": "string",
      "description": "Language of the lines when no voices are given."
    }
  },
  "required": [
    "script"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Record a script with exact timing, the way FreeTTS Script mode does: (pause 2) is exactly 2 seconds of silence, (beep), (ding) and (click) play a sound, 'CUE:' lines are read in a second voice, 'TRACK: name' starts a new audio file, 'NAME: line' makes a scene with a voice per character. Returns one file with everything plus one file per track. Use it for ear prompter tracks, voiceovers timed to footage, rehearsal tracks, workout or recipe step audio. Needs a connected FreeTTS PRO account.

{
  "type": "object",
  "properties": {
    "script": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60000,
      "description": "The script text. See freetts.org/text-to-speech-for-actors for the syntax."
    },
    "line_voice": {
      "type": "string",
      "description": "Voice for the main lines: a steady voice name or id (Guy, Andrew, Ava, Aria, Jenny, Brian, Emma, Sonia, Ryan, Libby, Natasha, William, Clara, Liam...). Default Guy."
    },
    "cue_voice": {
      "type": "string",
      "description": "Voice for CUE: lines and [bracketed] words. Default Aria."
    },
    "speed": {
      "type": "integer",
      "minimum": -30,
      "maximum": 30,
      "description": "Percent slower or faster for the main lines. Default 0."
    },
    "sentence_pause_ms": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3000,
      "description": "Silence after each sentence. Default 500."
    },
    "paragraph_pause_ms": {
      "type": "integer",
      "minimum": 0,
      "maximum": 5000,
      "description": "Silence after each paragraph. Default 1000."
    },
    "count_in": {
      "type": "string",
      "enum": [
        "none",
        "3",
        "5",
        "10"
      ],
      "description": "Spoken count-in before each track, one number a second. Default none."
    },
    "track_end": {
      "type": "string",
      "enum": [
        "none",
        "beep",
        "end"
      ],
      "description": "After the last line of each track: nothing, a long beep, or the word End. Default none."
    },
    "my_part": {
      "type": "string",
      "description": "In a scene, the character you play: their lines become timed gaps for you to say them."
    }
  },
  "required": [
    "script"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Turn a recording into text with FreeTTS speech to text. Give a public https URL to an audio file (mp3, wav, m4a, ogg, webm). Needs a connected FreeTTS PRO account.

{
  "type": "object",
  "properties": {
    "audio_url": {
      "type": "string",
      "format": "uri",
      "description": "Public https URL of the audio file."
    },
    "language": {
      "type": "string",
      "description": "Language of the recording, like 'en-US', 'de-DE', 'Arabic' or 'es', or 'auto' to detect it (default)."
    }
  },
  "required": [
    "audio_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}