---
title: "List a model's voices"
method: GET
path: "/ai/models/{modelId}/voices"
tags: ["AI"]
---

# List a model's voices

`GET /ai/models/{modelId}/voices`

## Request

- Base URL: `https://api.rendley.com/v1`
- URL: `https://api.rendley.com/v1/ai/models/{modelId}/voices`
- Auth: API key in header `Authorization`

Voices a voice model takes: on page 1 the recommended voices matching the filters, then public voice library voices page by page. Filter values come from GET /ai/models/{modelId}/voices/filters.

## Path parameters

- `modelId` string, required

## Query parameters

- `page` string
- `limit` string
- `query` string
- `gender` string
- `age` string
- `accent` string
- `language` string

## Response `200`

OK

- object
  - `data` AiManagerFeatureTextToSpeechVoiceResult[]: Success data
    - `accent` string
    - `age` string
    - `description` string
    - `gender` string
    - `id` string
    - `language` string
    - `model_id` string
    - `name` string
    - `preview_audio_url` string
    - `recommended` boolean: Recommended marks the curated voices, listed before library results.
    - `use` string
  - `error` HttpResponseAPIError
    - `code` string
    - `fields` HttpResponseFieldError[]
      - `field` string
      - `message` string
    - `message` string
  - `meta` unknown

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/rendley/apis/rendley-api.md) - [All operations](https://skmtc.dev/rendley/apis/rendley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rendley/apis/rendley-api/revisions/7eb8713bbf78?raw)