POST
/
text-to-voice
curl --request POST \
  --url https://client.camb.ai/apis/text-to-voice \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "text": "<string>",
  "voice_description": "<string>"
}'
{
  "task_id": "<string>"
}
A description consisting of at least 18 words (100+ characters) is required for voice generation. Requests with shorter prompts will not be processed successfully.

This endpoint initiates the process of creating a human-like voice based on the given text prompt describing the desired charasterics of the voice, returning a task_id. To check the status of the task, the /text-to-voice/{task_id} endpoint can be polled.

Authorizations

​
x-api-key
string
header
required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Body

application/json

Response

200
application/json
Successful response

A JSON that contains the unique identifier for the task. This is used to query the status of the text to voice task that is running. It is returned when a create request is made for creating a text to voice task.