---
title: "List Voices"
method: GET
path: "/v1/tts/vega/voices"
tags: ["Voice AI Beta — Vega"]
---

# List Voices

`GET /v1/tts/vega/voices`

## Request

- Base URL: `https://genaipro.io/api`
- URL: `https://genaipro.io/api/v1/tts/vega/voices`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/genaipro/apis/genaipro-api/docs/v1/tts/vega/voices/get.ts> (a function with typed inputs; its response is checked against the schema)

The static Vega catalog — 27 English voices (US/UK accents), sorted by quality grade. `cover_image` and `sample_url` are direct URLs (no proxy).
> **Rate limit:** 60 requests/minute

## Response `200`

Voice catalog

- TtsVegaVoicesResponse
  - `items` TtsVegaVoice[]
    - `id` string: Use as `voice` when creating a task
    - `name` string
    - `gender` 'female' | 'male'
    - `accent` 'us' | 'uk'
    - `grade` string: Quality grade (catalog is sorted by grade, descending)
    - `cover_image` string
    - `sample_url` string: Preview audio URL
  - `total` integer

## Other responses

- `429`: Rate limit exceeded

## Changes

- **2026-09-16** `c2782cee0caa`: 4 info
  - added the optional property `code` to the response with the `429` status
  - added the optional property `limit` to the response with the `429` status
  - added the optional property `retry_after` to the response with the `429` status
  - added the optional property `window_seconds` to the response with the `429` status

[Operation history](https://skmtc.dev/genaipro/apis/genaipro-api/changes/v1/tts/vega/voices/get.md)

---

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