---
title: "Create Voice Design Preview"
method: POST
path: "/v1/tts/sirius/voice-designs"
tags: ["Voice AI Beta — Sirius"]
---

# Create Voice Design Preview

`POST /v1/tts/sirius/voice-designs`

## Request

- Base URL: `https://genaipro.io/api`
- URL: `https://genaipro.io/api/v1/tts/sirius/voice-designs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/genaipro/apis/genaipro-api/docs/v1/tts/sirius/voice-designs/post.ts> (a function with typed inputs; its response is checked against the schema)

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

## Request body

- object
  - `instructions` string, required: Natural-language description of the voice
  - `seed` integer: Optional seed for reproducibility (`0` or omitted = random)

## Response `201`

Preview generation started

- TtsVoiceDesignPreviewCreated: Acknowledgement of a voice-design preview request
  - `id` string: Preview ID (poll via `GET /v1/tts/sirius/voice-designs/{id}`)
  - `seed` integer: Final seed used (your seed, or a random one when omitted/`0`)
  - `status` string

## Other responses

- `400`: Invalid instructions or seed
- `429`: Rate limit exceeded

## Changes

- **2026-09-16** `c2782cee0caa`: 4 info
  - added the optional property `code` to the response with the `429` status
  - added the optional property `limit` to the response with the `429` status
  - added the optional property `retry_after` to the response with the `429` status
  - added the optional property `window_seconds` to the response with the `429` status

[Operation history](https://skmtc.dev/genaipro/apis/genaipro-api/changes/v1/tts/sirius/voice-designs/post.md)

---

[API](https://skmtc.dev/genaipro/apis/genaipro-api.md) - [All operations](https://skmtc.dev/genaipro/apis/genaipro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/genaipro/apis/genaipro-api/revisions/74e909d7c324?raw)