Query voice-design quota

Query the current user's voice-design free-quota usage for today. The design and remix endpoints share the same quota.

10 free calls per day, counted on the UTC+8 calendar day; beyond that each call costs 100 credits (modules/voiceFactory.js:44-45).

remaining = 0 only means the free quota is exhausted; it does not mean you cannot keep calling — paid use is still available when credits suffice.
When credits are also insufficient, the design / remix endpoints return 403 (parent code BILLING_QUOTA_EXCEEDED, internal sub-code BILLING_DESIGN_QUOTA_EXCEEDED).

This endpoint does not consume quota and does not return business errors.

This endpoint has a single path; there is no /api/tts/voice/... compatibility alias.

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 ********************

application/json

查询成功

Bodyapplication/json

Example

{
    "status": 200,
    "data": {
        "used": 3,
        "free": 10,
        "remaining": 7,
        "nextResetAt": "2026-08-20T16:00:00.000Z"
    }
}

Request

Request Code Samples

Responses