Reset a style and reprocess its reference audio

Discard every derived artifact of this style and re-run reference-audio processing with the new processing switches. The original uploaded audio is not affected.

Fields cleared: style binding, preview audio, transcription text, audio duration, base speech rate;
v4.0 voices additionally clear the processed reference clip and instruct annotation (for v4.0 those two are the actual "style substance").

enhance and vocalFilter are unconditionally rewritten to the passed values (omitted is treated as false); it is not "keep existing if omitted".

Reset takes effect asynchronously: this endpoint only clears fields and returns immediately; the actual reprocessing is triggered on the next generate / preview.

This endpoint does not validate whether promptId exists: passing a non-existent style ID still returns 200, with no fields modified.

You can only operate voices you created, and the voice must not be in creating / failed. See the "Create a voice character" document.

INFO

Deprecated alias: /api/tts/voice/{id}/prompt/{promptId}/reset. See the site document "Versions and migration".

INFO

See the Errors document for the full code reference. Always use the X-Vocu-App-Request-Id response header when troubleshooting.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Reset. Returns the full voice character object after derived fields have been cleared.

Bodyapplication/json

Example

{
    "status": 200,
    "data": {
        "id": "7c3d9a12-5e84-4b06-9f21-8ad3e6b40c57",
        "name": "Gentle female voice",
        "status": "pending",
        "from": "upload",
        "version": "v3.0",
        "originId": null,
        "userId": "2f81b40c-9d63-4e17-a5b8-31c7d0e926af",
        "avatar": "https://storage.vocu.ai/avatar/voice/2f81b40c-9d63-4e17-a5b8-31c7d0e926af/7c3d9a12-5e84-4b06-9f21-8ad3e6b40c57.png",
        "createdAt": "2026-07-14T06:22:08.000Z",
        "updatedAt": "2026-08-19T11:04:37.000Z",
        "deletedAt": null,
        "metadata": {
            "description": "A gentle female voice for everyday narration",
            "avatar": "https://storage.vocu.ai/avatar/voice/2f81b40c-9d63-4e17-a5b8-31c7d0e926af/7c3d9a12-5e84-4b06-9f21-8ad3e6b40c57.png",
            "prompts": [
                {
                    "id": "default",
                    "name": "Default",
                    "description": "Calm narration",
                    "enhance": false,
                    "language": "zh",
                    "flags": [
                        "20250227-vcb",
                        "v3:20250828-vfa"
                    ],
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/2f81b40c-9d63-4e17-a5b8-31c7d0e926af/default-origin.wav",
                    "vocalFilter": false
                }
            ]
        }
    }
}

🟠400Bad request

🟠401Unauthorized

🟠403Forbidden

🟠404Not found

🟠409Conflict

🟠429Rate limited

🔴500Server error