Voice AI Beta — Sirius

Create Voice Design Preview

Changed on

Describe a voice in natural language and generate a preview asynchronously — free, no credits. Poll GET /v1/tts/sirius/voice-designs/{id} until status is done, listen to preview_url, then save the ones you like with POST /v1/tts/sirius/voice-designs/{id}/save. Pass the returned seed again to reproduce a preview.

Rate limit: 10 requests/hour

post/v1/tts/sirius/voice-designs

Request

Request body

instructionsstring required

Natural-language description of the voice

seedinteger

Optional seed for reproducibility (0 or omitted = random)

Example request

{
  "instructions": "A deep, calm male narrator with a slight rasp, mid-40s"
}

Response

Preview generation started

idstring

Preview ID (poll via GET /v1/tts/sirius/voice-designs/{id})

seedinteger

Final seed used (your seed, or a random one when omitted/0)

statusstring

Example response

{
  "status": "pending"
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status