Vocu Developers
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
Api Docs(Current)
User GuideBack To APP
Api Docs(Current)
User GuideBack To APP
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
  1. Async jobs
  • Overview
  • Authentication Method
  • Core
    • Voice Character
      • Manage
        • Get the list of voice characters for the current user
        • Get details of the voice character with the specified ID
        • Create a new voice character
        • Update a voice character's name and description
        • Upload avatar for the voice character with the specified ID
        • Delete Voice Character with the specified ID
      • Styles
        • Get the transcription of a style's reference audio
        • Add a style to the voice character with the specified ID
        • Correct the transcription of a style's reference audio
        • Update a style's name and description
        • Set a style as the default style
        • Reset a style and reprocess its reference audio
        • Delete Style of the specified ID for the Voice Character with the specified ID
    • Voice Generation
      • Async jobs
        • Get the list of asynchronous generation tasks for the current user
          GET
        • Get the details of an asynchronous generation task by ID
          GET
        • Create Asynchronous Voice Generation Task
          POST
        • Upload audio for voice conversion
          POST
        • Delete an asynchronous generation task by ID
          DELETE
      • Synchronous
        • List synthesis parameter presets
        • One-shot synthesis returning an MP3 stream directly
        • Synchronous real-time voice generation
  • Creative
    • Templates
      • Get User's Template List
      • Get Template Details with Specified ID
      • Create New Template
      • Update Template with Specified ID
      • Delete Template with Specified ID
  • Account
    • User
      • Get current user account information
  • Advanced
    • Splitter
      • List splitter configurations
      • Get splitter configuration details
      • Create a splitter configuration
      • Update a splitter configuration (diff mode)
      • Delete a splitter configuration
  • Schemas
    • Generation Template
    • Generation Task
    • Voice Character
    • General Generation Parameters (New)
    • ErrorResponse
  1. Async jobs

Delete an asynchronous generation task by ID

DELETE
https://v1.vocu.ai/api/tts/generate/{id}
A job in flight cannot be deleted: while status is pending or processing the call returns 403 GENERATE_DELETE_IN_PROGRESS, so wait until the job settles into generated / failed. There is no "cancel" semantics here, and the call will not abort a job that is already synthesising.
After deletion the job disappears from the list and detail endpoints, but the produced audio file is not removed and credits already charged are not refunded.
The response is just { status: 200 } with no data.
INFO
See the Errors document for the full code reference. Always use the X-Vocu-App-Request-Id response header when troubleshooting.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://v1.vocu.ai/api/tts/generate/' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Successfully deleted the generation task
application/json
Deleted (no data)
Bodyapplication/json

Example
{
    "status": 200,
    "message": "OK"
}
🟠401Unauthorized
🟠403Forbidden
🟠404Not found
🟠429Rate limited
Modified at 2026-08-23 09:24:46
Previous
Upload audio for voice conversion
Next
List synthesis parameter presets