Vocu Developers
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
Api Docs(Current)
User GuideBack To APP
Api Docs(Current)
User GuideBack To APP
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
  1. Styles
  • 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
          GET
        • Add a style to the voice character with the specified ID
          POST
        • Correct the transcription of a style's reference audio
          POST
        • Update a style's name and description
          POST
        • Set a style as the default style
          POST
        • Reset a style and reprocess its reference audio
          POST
        • Delete Style of the specified ID for the Voice Character with the specified ID
          DELETE
    • Voice Generation
      • Async jobs
        • Get the list of asynchronous generation tasks for the current user
        • Get the details of an asynchronous generation task by ID
        • Create Asynchronous Voice Generation Task
        • Upload audio for voice conversion
        • Delete an asynchronous generation task by ID
      • 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. Styles

Get the transcription of a style's reference audio

GET
https://v1.vocu.ai/api/voice/{id}/prompt/{promptId}/stt
Read the ASR transcription of this style's reference audio (data is the string itself, not an object).
Three lookup paths:
1.
The style already has cached textAsr → return it directly;
2.
v4.0 voice → take the transcription produced by emotion-controllable annotation, write it back as textAsr, and recompute base speech rate;
3.
Otherwise → query style info and likewise write the cache on success.
Transcription may be null: when the query succeeds but produces no transcription, { "status": 200, "data": null } is returned; this is not an error.
Only the query itself failing returns 500 SYSTEM_INTERNAL_ERROR.
A missing style ID returns 404 RESOURCE_NOT_FOUND (note: not VOICE_NOT_FOUND).
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}/stt. 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.

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 'https://v1.vocu.ai/api/voice//prompt//stt' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Success
application/json
Retrieved. data is the transcript string, or null when there is no transcript.
Bodyapplication/json

Example
{
    "status": 200,
    "data": "The weather is nice today. A good day to go out."
}
🟠400Bad request
🟠401Unauthorized
🟠403Forbidden
🟠404Not found
🟠409Conflict
🟠429Rate limited
🔴500Server error
Modified at 2026-08-23 09:24:46
Previous
Delete Voice Character with the specified ID
Next
Add a style to the voice character with the specified ID