Skip to main content
POST
/
v1
/
voice
/
design
Voice Design
curl --request POST \
  --url https://apis.finevoice.ai/v1/voice/design \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "taskId": "<string>",
  "engine": "v2",
  "prompt": "A warm, friendly female voice with a slight British accent",
  "previewText": "Hello, this is a preview of the designed voice.",
  "modelId": "<string>",
  "seed": 123
}
'
{}

Authorizations

​
Authorization
string
header
required

Bearer token (API key). Format: Bearer {your_api_key}

Body

application/json

The voice design request payload.

​
taskId
string

Task identifier for updating an existing design task.

​
engine
string

Voice generation engine. Supported: v1, v2.

Example:

"v2"

​
prompt
string

Voice design prompt describing desired voice characteristics.

Example:

"A warm, friendly female voice with a slight British accent"

​
previewText
string

Preview text used to audition the designed voice.

Example:

"Hello, this is a preview of the designed voice."

​
modelId
string

The base model identifier.

​
seed
integer<int64>

Random seed for deterministic generation.

Response

Voice design task accepted.

The response is of type object.