VoiceLabs
API ReferenceVoices and history

Download generated audio

Download the audio of a completed generation. This URL is not called directly — it is the `audio_url` returned by GET /v1/generations/{generationId}, already signed and ready to follow. The signature grants access to this one generation for about 15 minutes, so no API key is sent (and none is accepted): the link can be handed straight to a media player, a download, or an <audio> tag that cannot attach an Authorization header. Links expire — poll the generation again to mint a fresh one rather than storing this URL. Authenticated by the signature in the URL, not by an API key.

GET
/v1/audio/{generationId}

Download the audio of a completed generation. This URL is not called directly — it is the audio_url returned by GET /v1/generations/{generationId}, already signed and ready to follow. The signature grants access to this one generation for about 15 minutes, so no API key is sent (and none is accepted): the link can be handed straight to a media player, a download, or an tag that cannot attach an Authorization header. Links expire — poll the generation again to mint a fresh one rather than storing this URL.

Authenticated by the signature in the URL, not by an API key.

Path Parameters

generationId*string

The generation whose audio to download.

Length1 <= length

Query Parameters

sig*string

The capability signature. Supplied by audio_url; do not construct it.

Response Body

audio/*

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/audio/string?sig=string"
"string"

Get a generation GET

Look up a generation by id to poll its status (generating, completed, or failed). Returns 404 for an id that does not belong to this account. Requires the `voice:read` scope.

Pricing

VoiceLabs Pro is $8/month or $59/year with a 7-day free trial — one plan, 120 minutes of generated audio per month, no per-use fees.