Skip to main content
Version: 2.0.0

Get a voice

This endpoint retrieves a voice.

HTTP Request

GET https://app.resemble.ai/api/v2/voices/<voice_uuid>
URL ParametersTypeDescription
voice_uuidstringUUID of the voice to fetch
advancedbooleanReturns advanced voice information such as underlying model versions when set to true. For further information on model versions see Model Versions.

HTTP Response

{
"success": true,
"item": {
"uuid": <string>,
"name": <string>,
"status": <string>,
"default_language": <string>,
"voice_type": <string>,
"supported_languages": <string[]>,
"dataset_url": <string*>,
"callback_uri": <string*>,
"source": <string>,
"component_status": {
"text_to_speech": { "status": <string> },
"speech_to_speech": { "status": <string> },
"fill": { "status": <string> }
},
"api_support": {
"sync": <boolean>,
"async": <boolean>,
"direct_synthesis": <boolean>,
"streaming": <boolean>
},
"created_at": <UTC Date>,
"updated_at": <UTC Date>,
}
}
  • dataset_url and callback_uri will not be present in the response if the voice was not created using the API.
  • component_status represents the build status of each component that makes up a voice.
  • api_support represents what synthesis API's the voice can be used with.
  • voice_type can be professional or rapid.

Examples

NodeJS
1 2 3 4 5 import { Resemble } from '@resemble/node' Resemble.setApiKey('YOUR_API_TOKEN') await Resemble.v2.voices.get(voiceUuid)

Try it out

API Key:
Voice UUID:
Advanced: