Vocu Developers
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
Api Docs(Current)
User GuideBack To APP
Api Docs(Current)
User GuideBack To APP
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
  1. Voice Character
  • Overview
  • Authentication Method
  • Voice Character
    • Create a new voice character
      POST
    • Get the list of voice characters for the current user
      GET
    • Add a style to the voice character with the specified ID
      POST
    • Upload avatar for the voice character with the specified ID
      POST
    • Add a voice character to the account via a share ID
      POST
    • Get details of the voice character with the specified ID
      GET
    • Delete Voice Character with the specified ID
      DELETE
    • Get the one-time share link ID for the specified voice character ID
      GET
    • Delete Style of the specified ID for the Voice Character with the specified ID
      DELETE
    • Generate a voice-character preview clip
      POST
    • Update a voice character's name and description
      POST
    • Inspect and backfill missing voice-character fields
      POST
    • Get the transcription of a style's reference audio
      GET
    • Correct the transcription of a style's reference audio
      POST
    • Set a style as the default style
      POST
    • Update a style's name and description
      POST
    • Reset a style and reprocess its reference audio
      POST
    • Re-upload professional-cloning artifacts
      POST
    • Trigger automatic re-upload of professional-cloning artifacts
      POST
    • Migrate a voice character to v2.0
      POST
    • Migrate a voice character to v3.0
      POST
    • Start voice-character identity verification
      POST
    • Check voice-character identity-verification result
      POST
  • Voice Generation
    • Synchronous real-time voice generation
      POST
    • Create Asynchronous Voice Generation Task
      POST
    • Get the list of asynchronous generation tasks for the current user
      GET
    • Get the details of an asynchronous generation task by ID
      GET
    • Delete an asynchronous generation task by ID
      DELETE
    • Upload audio for voice conversion
      POST
    • Stream the full generated audio
      GET
    • Stream audio for a single content
      GET
    • Get the streaming playback URL for a whole generation task
      GET
    • List splitter configurations
      GET
    • Create a splitter configuration
      POST
    • Get splitter configuration details
      GET
    • Update a splitter configuration (diff mode)
      POST
    • Delete a splitter configuration
      DELETE
    • One-shot synthesis returning an MP3 stream directly
      GET
    • List synthesis parameter presets
      GET
    • Fetch a synthesized audio stream
      GET
    • Get SRT subtitles for synthesized audio
      GET
  • User Account
    • Get current user account information
  • Content Template
    • Create New Template
    • Get User's Template List
    • Update Template with Specified ID
    • Get Template Details with Specified ID
    • Delete Template with Specified ID
  • Real-time Synthesis
    • Create a Turbo real-time synthesis channel
    • List Turbo channels for the current user
    • Close a Turbo channel
  • Voice Design
    • Generate a voice preview from a text description
    • Generate a voice preview by remixing / translating existing audio
    • Confirm a voice design and create a voice character
    • Query voice-design quota
  1. Voice Character

Re-upload professional-cloning artifacts

POST
https://v1.vocu.studio/api/voice/{id}/reupload
Resubmit already-trained professional-cloning (LoRA) artifacts for a voice character in lora-need-reupload, triggering upstream reload and restarting the training poll.
This endpoint has a single path; there is no /api/tts/voice/... compatibility alias.
lora is the UUID of the local artifact; the server locates the artifact file on disk from it; a missing file returns VOICE_LORA_ARTIFACT_MISSING.
Status must be exactly lora-need-reupload; any other status is 400 VOICE_INVALID_STATE.
There is a 30-second concurrency lock on the "user + voice" dimension; a duplicate submit returns 429 RATE_LIMIT_CONCURRENT.
On success the voice status becomes lora-pending; the response is only { status: 200 }; poll separately for training progress.

Error responses take the shape { status, code, message, requestId? }. code is always the parent code — sub codes only change message and never appear in the body. requestId is present only on reportable-tier errors, so use the X-Vocu-App-Request-Id response header when troubleshooting (it is written unconditionally on every response). See the "Errors" document for the full code reference.

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 POST 'https://v1.vocu.studio/api/voice//reupload' \
--header 'Authorization: Bearer <token>'

Responses

🟢200成功
application/json
重传已受理,音色状态转为 lora-pending
Bodyapplication/json

Example
{
    "status": 200
}
🟠400请求有误
🟠401没有权限
🟠404记录不存在
🟠429
🔴503服务器故障
Modified at 2026-08-23 01:11:55
Previous
Reset a style and reprocess its reference audio
Next
Trigger automatic re-upload of professional-cloning artifacts