---
title: "Synthesize Voice (Text to Speech)"
method: POST
path: "/domains/{domain}/users/{user}/voices"
tags: ["Media/Text to Speech"]
---

# Synthesize Voice (Text to Speech)

`POST /domains/{domain}/users/{user}/voices`

## Path parameters

- `domain` string, required — This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. Then using in path for GET you can set to "~" to use the domain name linked to your token/key instead of the domain name itself when reading for your own domain.
- `user` string, required — This is the main user extension for the user account. ~ can be used to mean "my account" which will extract the user from the token/key used for authentication.

## Request body

- object
  - `script` string, required — This is a simple explanation of what the audio is and can include what is said in the audio file for explanation.
  - `voice_language` string — This is the language that can be requested when using TTS feature. Leave of to have API lookup configs from the defaults or domain specific configs.
  - `voice_id` string — This value will allow you to select the voice to be used for TTS applications. Value must be valid or will cause errors. leave off request to have the API lookup defaults from system and/or domain.

## Response `200`

## Other responses

- `400`
- `401`
- `404`

---

[API](https://skmtc.net/ns-api/apis/netsapiens-api-v2.md) · [All operations](https://skmtc.net/ns-api/apis/netsapiens-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ns-api/netsapiens-api-v2/revisions/d37f65b5b886/schema)