List Voices for LLM Model

curl --request GET \
  --url https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices \
  --header 'X-Api-Key: <api-key>'

import requests

url = "https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices"

headers = {"X-Api-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices")
  .header("X-Api-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Voices fetched successfully",
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "llm_model_id": "550e8400-e29b-41d4-a716-446655440000",
      "real_voice_id": "alloy",
      "voice_name": "Alloy",
      "real_voice_name": "alloy",
      "gender": "female",
      "language": "en",
      "recording_url": "https://cdn.ravan.ai/voices/alloy.mp3",
      "img_url": "https://cdn.ravan.ai/voices/alloy.png"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

GET

api

available-voice-ids

{llm_model_id}

voices

List Voices for LLM Model

curl --request GET \
  --url https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices \
  --header 'X-Api-Key: <api-key>'

import requests

url = "https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices"

headers = {"X-Api-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices")
  .header("X-Api-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Voices fetched successfully",
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "llm_model_id": "550e8400-e29b-41d4-a716-446655440000",
      "real_voice_id": "alloy",
      "voice_name": "Alloy",
      "real_voice_name": "alloy",
      "gender": "female",
      "language": "en",
      "recording_url": "https://cdn.ravan.ai/voices/alloy.mp3",
      "img_url": "https://cdn.ravan.ai/voices/alloy.png"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

Authorizations

string

required

Your Agni API key used to authenticate the request. Pass it in the X-Api-Key header.

Path Parameters

string

required

The unique ID of the LLM model to fetch voices for.

Query Parameters

integer

The maximum number of voice records to return. Example: 10.

integer

The number of voice records to skip before returning results. Example: 0.

Request

curl --location "https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices?limit=10&offset=0" \
  --header "X-Api-Key: YOUR_API_KEY"

Response

boolean

Whether the request succeeded.

string

Human-readable status message.

object[]

Voices available for the requested LLM model.

Show data[]

string

Unique voice ID. Use this value as the voice_id when creating or updating an agent.

string

ID of the LLM model this voice belongs to.

string

Provider-specific voice identifier. Example: alloy.

string

Display name of the voice.

string

Provider-specific voice name.

string

Voice gender label.

string

Voice language code.

string

URL for a sample recording.

string

URL for the voice image.

object

Pagination metadata.

Show meta

integer

Total number of voice records.

integer

Limit used for the request.

integer

Offset used for the request.

{
  "success": true,
  "message": "Voices fetched successfully",
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "llm_model_id": "550e8400-e29b-41d4-a716-446655440000",
      "real_voice_id": "alloy",
      "voice_name": "Alloy",
      "real_voice_name": "alloy",
      "gender": "female",
      "language": "en",
      "recording_url": "https://cdn.ravan.ai/voices/alloy.mp3",
      "img_url": "https://cdn.ravan.ai/voices/alloy.png"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

Authorizations

X-Api-Key

string

header

required

Path Parameters

llm_model_id

string<uuid>

required

LLM model ID

Query Parameters

limit

integer<int32>

The maximum number of voice records to return.

offset

integer<int32>

The number of voice records to skip before returning results.

Response

200 - application/json

Voices fetched successfully

success

boolean

message

string

data

object[]

Show child attributes

Introduction

Agent API

Organization API

Agent Tool API

Phone Number & Telephony API

Campaign API

Contact API

Calling API

Appointment API

GHL Integration API

Cal.com Integration API

RAG Knowledge Base API

Webhooks

Health API

List Voices for LLM Model

Authorizations

Path Parameters

Query Parameters

Request

Response

Authorizations

Path Parameters

Query Parameters

Response

​Authorizations

​Path Parameters

​Query Parameters

​Request

​Response

Authorizations

Path Parameters

Query Parameters

Response

Authorizations

Path Parameters

Query Parameters

Request

Response