allmodels.ioDocs
API ReferenceVoices

Search voices

Search voices available through AllModels. Filter by model, provider, language, category, or labels, and page through results with a cursor. No API key is required.

GET/v1/voices

Search voices available through AllModels. Filter by model, provider, language, category, or labels, and page through results with a cursor. No API key is required.

Query Parameters

q?string

Search voice names and descriptive metadata.

model?|array<string>

AllModels model ID. Repeat to match any supplied model.

provider?|array<string>

Provider ID. Repeat to match any supplied provider.

language?|array<string>

Language ID, such as en. Repeat to match any supplied language.

category?|array<string>

Voice category, such as official or community. Repeat to match any supplied category.

label?|array<string>

A facet:value filter, such as gender:female.

first_seen_after?string

Return voices added after this RFC 3339 timestamp.

Formatdate-time
sort?string

Sort by featured, relevance, newest, popularity, or name. Featured results place official voices before community voices. Relevance requires q.

Value in

  • "featured"
  • "relevance"
  • "newest"
  • "popular"
  • "name"
page_size?integer

Number of results to return.

Range1 <= value <= 100
Default20
cursor?string

next_cursor from the previous response.

include_facets?string

Include available filters and result counts.

Default"false"

Value in

  • "true"
  • "false"

Response Body

application/json

application/json

application/json

application/json

Client
Language
const response = await fetch("https://api.allmodels.io/v1/voices");if (!response.ok) throw new Error(`AllModels request failed: ${response.status}`);console.log(await response.json());
{  "voices": [    {      "model": {        "id": "string",        "name": "string"      },      "voice": {        "id": "string",        "name": "string",        "description": "string",        "category": {          "id": "string",          "name": "string"        },        "preview_url": "http://example.com",        "languages": [          {            "id": "string",            "name": "string",            "locale": "string",            "accent": "string"          }        ],        "labels": [          {            "facet": {              "id": "string",              "name": "string"            },            "value": {              "id": "string",              "name": "string"            }          }        ],        "source_urls": [          "http://example.com"        ],        "scope": {          "type": "global"        },        "first_seen_at": "2019-08-24T14:15:22Z",        "last_seen_at": "2019-08-24T14:15:22Z"      },      "providers": [        {          "id": "string",          "name": "string",          "default": true,          "provider_model_id": "string",          "metrics": {            "popularity_score": 0,            "likes": 0,            "saves": 0,            "shares": 0,            "uses": 0,            "characters_7d": 0,            "characters_1y": 0,            "clones": 0          }        }      ]    }  ],  "facets": [    {      "id": "string",      "name": "string",      "values": [        {          "id": "string",          "name": "string",          "count": 0        }      ]    }  ],  "total_count": 0,  "has_more": true,  "next_cursor": "string",  "catalogue_updated_at": "2019-08-24T14:15:22Z"}
{  "error": "not_found"}
{  "error": "catalogue_changed"}
{  "error": "voice_catalogue_unavailable"}