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

# List Voices

`GET /v1/tts/sirius/voices`

## Request

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

The Sirius preset catalog (9 cross-lingual voices — every voice speaks ~10 languages; `accent` is the voice's characteristic color: `english`, `chinese`, `japanese`, `korean`). `personal_voices` additionally lists **your** ready voice designs.
> **Rate limit:** 60 requests/minute

## Response `200`

Preset catalog + your personal voices

- TtsSiriusVoicesResponse
  - `items` TtsSiriusVoice[]: Public preset catalog
    - `id` string: Use as `voice` when creating a task
    - `name` string
    - `gender` 'female' | 'male'
    - `accent` string: Characteristic accent color: `english`, `chinese`, `japanese`, `korean`
    - `style` string: Short voice descriptor (display only)
    - `grade` string: Quality grade (display only)
    - `cover_image` string
    - `sample_url` string: Preview audio URL (may be empty)
    - `tags` string[]
  - `total` integer
  - `personal_voices` TtsPersonalVoice[]: Your ready voice designs (empty when none)
    - `id` string: Use as `voice_design_id` when creating a task
    - `title` string
    - `cover_image` string
    - `created_at` string, date-time

## 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/sirius/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)