List Voices
FreshGETGET https://api.creatify.ai/api/voices/Retrieve the full list of all available voices. This includes built-in voices across multiple languages and accents.
Headers
| Header | Type | Required | Description |
|---|---|---|---|
X-API-ID | string | Yes | Your Creatify API ID |
X-API-KEY | string | Yes | Your Creatify API key |
Example Request
bash
curl -X GET 'https://api.creatify.ai/api/voices/' \
-H 'X-API-ID: your-api-id' \
-H 'X-API-KEY: your-api-key'Response
json
[
{
"id": "voice-en-001",
"name": "Sarah",
"language": "en",
"accent": "American",
"gender": "female",
"preview_url": "https://cdn.creatify.ai/voices/sarah-preview.mp3"
},
{
"id": "voice-en-002",
"name": "James",
"language": "en",
"accent": "British",
"gender": "male",
"preview_url": "https://cdn.creatify.ai/voices/james-preview.mp3"
}
]Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique voice identifier (use this in other API calls) |
name | string | Human-readable voice name |
language | string | Language code |
accent | string | Accent or dialect |
gender | string | Voice gender |
preview_url | string | URL to a sample audio clip |
Status Codes
| Code | Description |
|---|---|
200 | Success |
401 | Unauthorized -- invalid API credentials |
429 | Rate limit exceeded |
500 | Internal server error |
TIP
Use the id field from this response as the voice_id parameter in avatar creation, text-to-speech, and other endpoints that accept a voice selection.