GET
/
higgsfield
/
voices
Get Voices
curl --request GET \
  --url https://api.unifically.com/higgsfield/voices \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "items": [
      {
        "id": "1YxkwUwGY4H3slvZUBRhXW",
        "name": "Professional Male",
        "category": "podcast",
        "preview_url": "https://..."
      }
    ],
    "cursor": "next_page_cursor",
    "total": 150,
    "error": {}
  }
}
Fetch available voices for Text-to-Speech generation with optional category filtering.

​
Pricing

For current pricing, see the Pricing page.

​
Authentication

All endpoints require authentication using Bearer token authorization: 
-H 'Authorization: Bearer YOUR_API_KEY'

​
Request

curl -X GET 'https://api.unifically.com/higgsfield/voices?size=20&category=podcast' \
  -H 'Authorization: Bearer YOUR_API_KEY'

​
Parameters

​
size
integer
Number of voices to return per pageDefault: 14
​
cursor
string
Pagination cursor for fetching next page
​
category
string
Filter by voice category. If not provided, returns all voicesOptions: "emotions", "stream", "car talk", "podcast", "vlog", "forum", "coaching", "reporter", "selling", "beauty", "professions", "other"

​
Response

{
  "code": 200,
  "data": {
    "items": [
      {
        "id": "1YxkwUwGY4H3slvZUBRhXW",
        "name": "Professional Male",
        "category": "podcast",
        "preview_url": "https://..."
      }
    ],
    "cursor": "next_page_cursor",
    "total": 150,
    "error": {}
  }
}

​
Response Fields

​
code
integer
default:"200"
HTTP status code (200 for success)
​
data
object
Response data
​
items
array
Array of voice objects
​
id
string
Unique voice identifier
​
name
string
Display name of the voice
​
category
string
Voice category
​
preview_url
string
URL to preview the voice
​
cursor
string
Pagination cursor for fetching next page
​
total
integer
Total number of voices available
​
error
object
Error information (empty object for successful requests)

​
Error Response

​
Invalid Category:

{
  "code": 400,
  "data": {
    "message": "Invalid category. Valid categories are: emotions, stream, car talk, podcast, vlog, forum, coaching, reporter, selling, beauty, professions, other",
    "error": {}
  }
}