Voices

List all supported voices for given language and dialect.

Request

GEThttps://api.fliki.ai/v1/voices

Headers

{
  "Content-type": "application/json",
  "Authorization": "Bearer API_KEY"
}

Key	Value	Description
Content-Type	application/json	Specifies that the request body format is JSON, allowing the server to parse the data correctly.
Authorization	Bearer YOUR_API_KEY	Generate your API Key in the account/api. section and replace YOUR_API_KEY with your actual key.

Query params

{
  "languageId": String,
  "dialectId": String
}

Key	Type	Description
languageId	string	Unique identifier for each language.
dialectId	string	Unique identifier for each dialect within a language.

Obtain languageId via the languages endpoint. Obtain dialectId via the dialects endpoint.

Response

[
  {
    "_id": String,
    "name": String,
    "gender": String,
    "isUltra": String,
    "audioSample": String,
    "styles": [
      {
        "_id": String,
        "style": String,
        "audioSample": String
      }
    ]
  },
]

Key	Type	Description
_id	string	Unique identifier for each voice. This is the voiceId.
name	string	Name of the voice (e.g., “John”, “Emma”).
gender	string	Gender of the voice (e.g., “male”, “female”).
isUltra	string	Indicates if the voice is an “Ultra” realistic voice.
audioSample	string	URL or path to the audio sample for the voice.
styles	array	Available speaking styles for the voice (may be empty).

Each entry in styles is a style variation you can request with voiceStyleId:

Key	Type	Description
_id	string	Unique identifier for the style. This is the voiceStyleId.
style	string	Style name (e.g., “cheerful”, “sad”, “newscast”).
audioSample	string	URL or path to the audio sample for that style.

tip

Prefer clicking over calling? You can also copy any of these IDs straight from the app. See Finding your IDs.

Example

Bash

cURL Request

curl \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -X GET "https://api.fliki.ai/v1/voices?languageId=...&dialectId=..."

TypeScript

TypeScript Request

const apiKey = '<API_KEY>'; // Replace with your actual API key
const languageId = '...'; // Replace with your actual language ID
const dialectId = '...'; // Replace with your actual dialect ID

async function getVoices(apiKey: string, languageId: string, dialectId: string) {
const url = `https://api.fliki.ai/v1/voices?languageId=${encodeURIComponent(languageId)}&dialectId=${encodeURIComponent(dialectId)}`;

  try {
    const response = await fetch(url, {
      method: 'GET',
      headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json',
      },
    });

    if (!response.ok) {
      throw new Error(`Error: ${response.status} - ${response.statusText}`);
    }

    const data = await response.json();
    console.log(data);

  } catch (error) {
    console.error('Error fetching voices:', error);
  }

}

getVoices(apiKey, languageId, dialectId);

Python

Python Request

import requests

api_key = "<API_KEY>"
language_id = "..." # Replace with your actual language ID
dialect_id = "..." # Replace with your actual dialect ID

url = "https://api.fliki.ai/v1/voices"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
params = {
"languageId": language_id,
"dialectId": dialect_id
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

Go

Go Request

package main

import (
"encoding/json"
"fmt"
"net/http"
)

func main() {
apiKey := "<API_KEY>"
languageID := "..." // Replace with your actual language ID
dialectID := "..." // Replace with your actual dialect ID

  url := "https://api.fliki.ai/v1/voices"
  req, err := http.NewRequest("GET", url, nil)
  if err != nil {
    panic(err)
  }

  req.Header.Set("Authorization", "Bearer "+apiKey)
  req.Header.Set("Content-Type", "application/json")

  q := req.URL.Query()
  q.Add("languageId", languageID)
  q.Add("dialectId", dialectID)
  req.URL.RawQuery = q.Encode()

  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  var result map[string]interface{}
  json.NewDecoder(resp.Body).Decode(&result)
  fmt.Println(result)

}