Create speech

Create speech

post

Generate speech from provided text.

Authorizations

bearerAuth

AuthorizationstringRequired

Your ShortGenius API token

Body

application/json

textstringRequired

The text to generate speech from.

localestring · enumOptional

The locale of the text.

Default: autoPossible values:

voice_idstringRequired

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

wait_for_generationbooleanOptional

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.

Default: false

Responses

200

Successful response

application/json

Details about the created or retrieved audio media.

idstring · uuidRequired

Unique ID of the audio.

created_atstringRequired

Date and time (ISO 8601) when the audio media was created.

updated_atstring · nullableOptional

Date and time (ISO 8601) when the audio media was last updated.

urlstring · nullableRequired

URL of the audio. Only available after the audio is generated.

user_idstring · uuidRequired

ID of the user who generated the audio.

categorystring · enumRequired

Category of the audio.

Possible values:

statestring · enumRequired

State of the audio generation.

Possible values:

textstring · nullableOptional

Source text of the audio.

localestring,null · enum · nullableOptional

Locale of the audio to guide the AI. Auto-detected if not provided.

Possible values:

durationnumber · nullableOptional

Duration of the generated audio. Only available after the audio is generated.

lufsnumber · nullableOptional

Loudness normalization value in LUFS. Only available after the audio is generated.

400

Invalid request

application/json

401

Unauthorized request

application/json

post

/audio/speech

HTTPcURLJavaScriptPython

POST /api/v1/audio/speech HTTP/1.1
Host: shortgenius.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "text": "text",
  "locale": "auto",
  "voice_id": "text",
  "wait_for_generation": false
}

{
  "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
      }
    ]
  },
  "category": "AIGeneratedAudio",
  "state": "pending",
  "text": null,
  "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
}