voices

Hear a voice

Synthesise a short sentence in one of the catalogue's voices and answer a short-lived link to the audio. Send your own text (up to 300 characters) or omit it for a stock sentence. The same sentence in the same voice is only ever synthesised once, so repeating a preview is free and instant. When somebody else is synthesising this exact preview at this moment the answer is status: "preview_pending" with no URL — ask again in a second.

post/voices/preview

Request

  • Base URL: https://api.gogoscreen.com/api/v1
  • URL: https://api.gogoscreen.com/api/v1/voices/preview
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

textstring

The sentence to speak. Omit for a stock one.

voiceIdstring required

A voice id from catalog.voices.list.

Response

Hear a voice

cachedboolean required

True when the audio already existed and nothing was synthesised.

expiresAtstring date-time nullable required
status'ready' | 'preview_pending' required
urlstring nullable required

A signed link to the audio. Null while the preview is still being made.

Changes

No recorded changes to this operation across all 1 revision of this API.