VoiceLabs
API ReferenceVoices and history

List voices

List the voice profiles on this account — both cloned voices and built-in presets — with language, default engine, and usage counts. A new account has none until a voice is created. Requires the `voice:read` scope.

GET
/v1/voices

List the voice profiles on this account — both cloned voices and built-in presets — with language, default engine, and usage counts. A new account has none until a voice is created.

Requires the voice:read scope.

Authorization

x-api-key<token>

A VoiceLabs API key, sent in the x-api-key header. Keys begin with vl_sandbox_. This is the simplest way to authenticate and is what most callers should use.

Create one in the developer console at https://voicelabs.now/connections, on the API keys tab, choosing the scopes it carries. A key does exactly what its scopes allow: one without voice:generate is answered 403 insufficient_scope on the generation operations and cannot spend the account's allowance. The secret is shown once, at creation; revoking a key takes effect on its very next request.

In: header

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/voices"
{  "data": [    {      "id": "string",      "name": "string",      "description": "string",      "language": "string",      "voice_type": "string",      "default_engine": "string",      "has_personality": true,      "generation_count": 0,      "sample_count": 0,      "created_at": "string",      "updated_at": "string"    }  ],  "total": 0}

Create a transcription POST

Transcribe a base64-encoded audio clip to text. Returns the transcript along with the id of the capture it created, which stays retrievable through GET /v1/captures. Send an Idempotency-Key header to make a retried request safe. Requires the `voice:generate` scope.

List captures GET

List this account's recent captures with their transcripts, most-recent first. Paginated with `limit` (1-200, default 50) and `offset`. Requires the `voice:read` scope.