Skip to main content
GET
Get a voice clone
When to use: to check a new clone or hear samples. 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

voice_clone_id
string
required

Voice clone id.

Maximum string length: 64

Response

OK: VoiceClone.

A reusable workspace voice clone.

object
enum<string>
required

Always voice_clone.

Available options:
voice_clone
id
string
required

Voice clone id.

name
string
required

Name.

status
enum<string>
required

Voice clone status.

  • processing: being created
  • ready: usable
  • failed: see failure
Available options:
processing,
ready,
failed
failure
object | null
required

Why it failed.

source
object
required

Source of a voice clone: a union on type.

settings
object
required

Voice clone settings.

languages
object[] | null
required

Only in getVoiceClone; null in lists.

samples_status
enum<string>
required

Sample status.

  • ready: samples match the settings
  • regenerating: being regenerated
  • stale: regeneration failed; settings still apply
Available options:
ready,
regenerating,
stale
created_at
string<date-time>
required

Creation time.