List voices in the library

curl --request GET \
  --url https://{subdomain}.mihu.ai/api/v1/voice_library \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{subdomain}.mihu.ai/api/v1/voice_library', 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://{subdomain}.mihu.ai/api/v1/voice_library",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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://{subdomain}.mihu.ai/api/v1/voice_library"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{subdomain}.mihu.ai/api/v1/voice_library")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "success": true,
  "message": "Voice library retrieved successfully",
  "data": {
    "items": [
      {
        "uuid": "ebeba3e0-89b5-4c94-9841-9555ab155dbc",
        "name": "Giulia",
        "language": "it",
        "gender": "female",
        "accent": "standard",
        "age": "adult"
      }
    ],
    "pagination": {
      "current_page": 1,
      "total": 123,
      "last_page": 123,
      "per_page": 123
    }
  }
}

{
  "success": false,
  "message": "Agent not found",
  "data": []
}

{
  "success": false,
  "message": "Agent not found",
  "data": []
}

GET

api

voice_library

List voices in the library

curl --request GET \
  --url https://{subdomain}.mihu.ai/api/v1/voice_library \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{subdomain}.mihu.ai/api/v1/voice_library', 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://{subdomain}.mihu.ai/api/v1/voice_library",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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://{subdomain}.mihu.ai/api/v1/voice_library"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{subdomain}.mihu.ai/api/v1/voice_library")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "success": true,
  "message": "Voice library retrieved successfully",
  "data": {
    "items": [
      {
        "uuid": "ebeba3e0-89b5-4c94-9841-9555ab155dbc",
        "name": "Giulia",
        "language": "it",
        "gender": "female",
        "accent": "standard",
        "age": "adult"
      }
    ],
    "pagination": {
      "current_page": 1,
      "total": 123,
      "last_page": 123,
      "per_page": 123
    }
  }
}

{
  "success": false,
  "message": "Agent not found",
  "data": []
}

{
  "success": false,
  "message": "Agent not found",
  "data": []
}

Authorizations

Authorization

string

header

required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Query Parameters

language

string

ISO language code (e.g. it, en, tr).

gender

string

Voice gender (male, female, neutral).

accent

string

Voice accent label.

string

Partial match on voice name.

page

integer

default:1

Required range: x >= 1

per_page

integer

default:25

Required range: 1 <= x <= 100

Response

Voices retrieved successfully

success

boolean

Example:

true

message

string

Example:

"Voice library retrieved successfully"

data

object

Show child attributes

API Documentation

API Reference

List voices in the library

Authorizations

Query Parameters

Response