---
title: "List text-to-speech voices"
method: GET
path: "/api/v1/voices"
tags: ["Catalog"]
---

# List text-to-speech voices

`GET /api/v1/voices`

## Request

- Base URL: `https://viewmax.studio`
- URL: `https://viewmax.studio/api/v1/voices`
- Auth: none required

Public catalog of voices for POST /api/v1/speech, with the speech pricing rule. No API key required. Cached for up to an hour.

## Response `200`

Voice catalog.

- object
  - `code` 0, required
  - `message` 'ok', required
  - `data` VoiceCatalog, required
    - `default_model` string, required
    - `characters_per_credit` integer, required: Speech costs `max(minimum_credits, ceil(text characters / characters_per_credit))`.
    - `minimum_credits` integer, required
    - `voices` Voice[], required
      - `id` string, required: Send as `voice_id`.
      - `name` string, required
      - `gender` string
      - `language` string, required
      - `languages` string[]
      - `accent` string
      - `use_case` string
      - `description` string
      - `preview_url` string, uri
      - `recommended_model` string: Default `options.model_id` for this voice.

---

[API](https://skmtc.dev/viewmax/apis/viewmax-studio-api.md) · [All operations](https://skmtc.dev/viewmax/apis/viewmax-studio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viewmax/apis/viewmax-studio-api/revisions/c4f378e09f44?raw)