Create a preset

This endpoint creates a new voice settings preset with your specified configuration.

Limitations

• Maximum 5 presets per user
• Preset name must be unique among your active presets
• Name must be 30 characters or less

HTTP Request

POST https://app.resemble.ai/api/v2/voice_settings_presets

Request Body

Parameter	Type	Required	Validation	Description
name	string	✅ Yes	Max 30 characters	Preset name (must be unique)
pace	number	No	0.2 - 2.0	Speech pace/speed (default: 1.0)
temperature	number	No	0.1 - 5.0	Voice variation (default: 0.8)
pitch	number	No	-10 to 10	Voice pitch adjustment (default: 0.0)
useHd	boolean	No	true/false	Use HD quality (default: false)
exaggeration	number	No	0.0 - 1.0	Emotional exaggeration (default: 0.5)
description	string	No	Max 1000 characters	Voice style prompt (default: "")

Default Values

If not provided, the following defaults are used:

• pace: 1.0
• temperature: 0.8
• pitch: 0.0
• useHd: false
• exaggeration: 0.5
• description: ""

HTTP Response

Success Response (201)

{
    "success": true,
    "data": {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "name": "My Custom Preset",
        "settings": {
            "pace": 1.2,
            "temperature": 1.1,
            "pitch": 0.5,
            "useHd": false,
            "exaggeration": 0.7,
            "description": "Speak with high energy and enthusiasm"
        },
        "is_public": false,
        "created_at": "2024-01-01T00:00:00Z",
        "updated_at": "2024-01-01T00:00:00Z"
    },
    "message": "Preset created successfully"
}

Error Response (422)

{
    "success": false,
    "errors": ["Name is required", "pace must be between 0.2 and 2.0"],
    "message": "Failed to create preset"
}

Common Errors

Error Message	Cause
"Name is required"	Missing name field
"You have reached the maximum limit of 5 presets"	Already have 5 custom presets
"Name must be unique"	Another preset with this name exists
"pace must be between 0.2 and 2.0"	Invalid pace value
"temperature must be between 0.1 and 5.0"	Invalid temperature value
"pitch must be between -10 and 10"	Invalid pitch value

Examples

NodeJS

1 Coming soon...

Try it out

API Key:

JSON Body:

{ "name": "Energetic Voice", "pace": 1.2, "temperature": 1.1, "pitch": 0.5, "useHd": false, "exaggeration": 0.7, "description": "Speak with high energy and enthusiasm" }