Skip to main content
GET
List voices for a target language
Lists the voices a new project in this target language can use, before any project exists: stock voices and workspace voice clones, each with a pre-generated sample and whether it works with meaning-first dubbing. Same shape as listProjectVoices; assigned_speaker_ids is always empty and selectable always true. Instant clones belong to a project’s speakers and are not listed. When to use: to choose speaker_voices for createProject or estimateProject. For an existing project use listProjectVoices. Side effects: None. Cost: Free. Idempotency: safe and pure (never writes); retry freely. Pagination: limit (default 100, max 500) and cursor; follow next_cursor until has_more is false. Required scopes: voices:read Errors: target_language_not_supported (422)

Authorizations

Authorization
string
header
required

API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).

Scopes

voices:read

Query Parameters

target_language
string
required

Target language code (listLanguages).

Maximum string length: 32
dubbing_model
enum<string>

The voices a new project with this model would get; omitted means v2, the default of createProject. Dubbing model.

  • v1: the legacy dubbing engine
  • v2: meaning-first dubbing (Dubbing 2.0)
Available options:
v1,
v2
limit
integer<int32>
default:100

Page size.

Required range: 1 <= x <= 500
cursor
string

Opaque cursor from next_cursor; keep the same filters on every page.

Maximum string length: 2048
type
enum<string>

Only this voice type. Voice type.

  • stock: a catalog voice
  • instant_clone: the speaker's own voice cloned for this project
  • library_clone: a workspace voice clone
  • rask_tts: Rask TTS (free variants)
Available options:
stock,
instant_clone,
library_clone,
rask_tts
gender
enum<string>

Only this gender. Voice gender.

  • male: male
  • female: female
  • unspecified: unspecified
Available options:
male,
female,
unspecified
free
boolean

Only free (true) or paid (false) voices.

meaning_first_compatible
boolean

Only voices usable with meaning-first dubbing.

name_contains
string

Only voices whose name contains this text (1-100 characters, case-insensitive).

Required string length: 1 - 100

Response

OK: VoiceList.

A page of Voice (the list envelope shared by every list).

object
enum<string>
required

Always list.

Available options:
list
data
object[]
required

Items of this page.

next_cursor
string | null
required

Pass as cursor for the next page; null on the last page.

has_more
boolean
required

More items exist (a page may hold fewer than limit items while has_more is true).