Get the transcription of a style's reference audio

Read the ASR transcription of this style's reference audio (data is the string itself, not an object).

Three lookup paths (routes/voice/prompt.js:30-85):

The style already has cached textAsr → return it directly;

v4.0 (no upstream binding) voice → take the transcription produced by instruct-side annotation, and opportunistically write it back as textAsr and recompute base speech rate;

Otherwise → query style info from upstream, and likewise write the cache on success.

Transcription may be null: when the upstream call succeeds but produces no transcription, { "status": 200, "data": null } is returned; this is not an error.
Only the upstream call itself failing returns 500 SYSTEM_INTERNAL_ERROR.

A missing style ID returns 404 RESOURCE_NOT_FOUND (note: not VOICE_NOT_FOUND).

Ownership and status checks (modules/routeHelpers.js:254-280, modules/voiceFactory.js:257-270):

Voice does not exist, does not belong to the current user, or has been soft-deleted → 404 VOICE_NOT_FOUND (the three cases are not distinguished)

status = creating → 409 VOICE_CREATING

status = failed → 400 VOICE_CREATE_FAILED

from != upload (e.g. a market-purchased / community-imported voice) → 403 AUTH_FORBIDDEN

Lazy version migration has not finished → 500 SYSTEM_INTERNAL_ERROR (retryable)

Legacy alias: /api/tts/voice/{id}/prompt/{promptId}/stt — still supported for backward compatibility; use the primary path for new integrations.

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.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200成功

application/json

获取成功。data 为转写文本字符串；无转写结果时为 null

Bodyapplication/json

Example

{
    "status": 200,
    "data": "今天天气不错，适合出门走走。"
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠409

🟠429

🔴500服务器错误

Get the transcription of a style's reference audio

Request

Request Code Samples

Responses