Create speech

ShortGenius API

ShortGenius

Generate speech from provided text.

post

/audio/speech

Authorizations

Body

textstringrequired

The text to generate speech from.

localestring · enum · default: auto

The locale of the text.

Options: af-ZA, id-ID, ms-MY, ca-ES, cs-CZ, da-DK, de-DE, en-US, es-ES, es-419, fr-CA, fr-FR, hr-HR, it-IT, hu-HU, nl-NL, no-NO, pl-PL, pt-BR, pt-PT, ro-RO, sk-SK, fi-FI, sv-SE, vi-VN, tr-TR, el-GR, ru-RU, sr-SP, uk-UA, hy-AM, he-IL, ur-PK, ar-SA, hi-IN, th-TH, ko-KR, ja-JP, zh-CN, zh-TW, auto

voice_idstringrequired

The voice to use for speech generation. See the List voices endpoint.

wait_for_generationboolean · default: false

If false, this endpoint immediately returns the incomplete speech record, and you can poll the Get speech endpoint until the task completes. If true, this endpoint waits until the speech generation completes, then returns the complete speech record. Defaults to false.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://shortgenius.com/api/v1/audio/speech' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "text": "text",
    "locale": "auto",
    "voice_id": "text",
    "wait_for_generation": false
  }'

200

400

401

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "text",
  "updated_at": null,
  "url": null,
  "user_id": "123e4567-e89b-12d3-a456-426614174000",
  "transcript": {
    "words": [
      {
        "text": "text",
        "start": 1,
        "end": 1,
        "confidence": 1
      }
    ]
  },
  "state": "pending",
  "text": "text",
  "locale": "af-ZA",
  "voice": {
    "id": "text",
    "name": "text",
    "description": null,
    "avatar_url": null,
    "flag_url": null,
    "tags": {
      "language": null,
      "accent": null,
      "age": null,
      "category": null,
      "gender": null,
      "tone": null,
      "useCase": null
    },
    "preview_url": null,
    "locale": "af-ZA",
    "source": "Cartesia"
  },
  "duration": null,
  "lufs": null
}

Successful response