---
title: "Save Voice Design"
method: POST
path: "/v1/tts/sirius/voice-designs/{id}/save"
tags: ["Voice AI Beta — Sirius"]
---

# Save Voice Design

`POST /v1/tts/sirius/voice-designs/{id}/save`

## Request

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

Save a `done` preview as a persistent voice design (max **3** saved designs per account; each preview can be saved once). The saved design is `ready` immediately — use its `id` as `voice_design_id` when creating tasks.
> **Rate limit:** 60 requests/hour

## Path parameters

- `id` string, required

## Request body

- object
  - `title` string, required: Display name for the saved design

## Response `201`

Design saved

- TtsVoiceDesign: A saved voice design
  - `id` string: Use as `voice_design_id` when creating a task
  - `title` string
  - `design_instructions` string
  - `cover_image` string
  - `sample_url` string: Preview audio URL (may be empty)
  - `status` 'ready' | 'failed'
  - `created_at` string, date-time

## Other responses

- `400`: Preview not `done`, invalid title, or design quota (3) reached
- `404`: Not found
- `409`: This preview has already been saved

---

[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/264ca07ba262?raw)