查询主key用量

GET

https://api.voicelibrary.co/enterprise/v1/user/usage

查询主 Key 字符消耗

查询主 API Key 及其子 Key 在指定时间范围内的聚合用量。请求地址：

GET https://api.voicelibrary.co/enterprise/v1/user/usage

使用 api-key Header 鉴权；可传 start_date 和 end_date，格式为 YYYY-MM-DD。不传日期时使用接口默认当月范围，以响应中的 start_date / end_date 为准。

请求 model_id	对应字符字段
`myvocal_v3`	`tts.v3_chars`
`myvocal_v4`	`tts.v4_chars`
`myvocal_v3_turbo`	`tts.v3_turbo_chars`
所有 TTS 模型汇总	`tts.total_chars`

字符用量字段为整数。HTTP 合成与对话 Multi-Context WSS 的用量均可通过对应模型字段查询。

字符用量以接口返回值为准。

若账户响应含 tts.quota_limit，它表示 TTS 配额，不是消耗；ivc、pvc 为声音克隆相关用量及配额，不应加到 TTS 字符消耗中。下方响应是示意数据。

请求参数

Query 参数

Header 参数

返回响应

🟢200usage

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://api.voicelibrary.co/enterprise/v1/user/usage?start_date=2026-10-15&end_date=2026-10-15' \
--header 'api-key: YOUR_API_KEY' \
--header 'Content-Type: text/plain' \
--data ''

响应示例

{
    "user_id": "string",
    "start_date": "string",
    "end_date": "string",
    "expire_at": "string",
    "status": "string",
    "shared_concurrency": 0,
    "dedicated_concurrency": 0,
    "tts": {
        "turbo_chars": 0,
        "v2_chars": 0,
        "v3_chars": 0,
        "v4_chars": 0,
        "v3_turbo_chars": 0,
        "skyblight_chars": 0,
        "total_chars": 0,
        "quota_limit": 0
    },
    "ivc": {
        "total_used": 0,
        "quota_limit": 0
    },
    "pvc": {
        "total_used": 0,
        "quota_limit": 0
    }
}

用量与请求查询

Request_id客户端查询

查询主key用量

查询主 Key 字符消耗#

请求参数

返回响应

查询主 Key 字符消耗