Skip to main content
GET
Get a speaker
When to use: before updateSpeakerVoice, to get the current ETag. Side effects: None. Cost: Free. Idempotency: safe and pure (never writes); retry freely. Required scopes: voices:read

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

Path Parameters

project_id
string
required

Project id (from createProject or listProjects).

Maximum string length: 64
speaker_id
string
required

Speaker id.

Maximum string length: 11
Pattern: ^SPEAKER_\d{2,3}$

Response

OK: Speaker.

A speaker of a project.

object
enum<string>
required

Always speaker.

Available options:
speaker
id
string
required

Speaker id, e.g. SPEAKER_00 (shown to users as "Speaker 1").

label
string
required

Display name that users and the web app use: "Speaker N" for SPEAKER_{N-1} (e.g. "Speaker 2" for SPEAKER_01).

number
integer<int32>
required

1-based speaker number (N in "Speaker N").

Required range: x >= 1
project_id
string
required

Project.

voice
object | null
required

Assigned voice.

voice_origin
enum<string> | null
required

Where the voice came from; null while there is no voice.

Available options:
requested,
suggested,
assigned
instant_clone_settings
object | null
required

When the voice is the instant clone.

segment_count
integer<int32>
required

Segments.

speech_seconds
number<double>
required

Speech duration.

voice_pending
boolean
required

No voice yet; voice suggestion is running.

instant_clone
object
required

Whether the instant clone is available.

etag
string
required

ETag for If-Match on updateSpeakerVoice.