Skip to main content
GET
/
api
/
v1
/
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>'
{
  "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
required
Your Agni API key used to authenticate the request. Pass it in the X-Api-Key header.

​
Path Parameters

​
llm_model_id
string
required
The unique ID of the LLM model to fetch voices for.

​
Query Parameters

​
limit
integer
The maximum number of voice records to return. Example: 10.
​
offset
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

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object[]
Voices available for the requested LLM model.
​
meta
object
Pagination metadata.
{
  "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[]
​
meta
object