查询用量
GET
https://openapi.myvocal.ai/asr/v1/usage
发起查询
API-Key 请求头鉴权。日期使用 YYYY/MM/DD，例如 2026/10/13；不要使用 2026-10-13。period 用于核对服务端接受的范围。接口没有时区参数；跨时区对账时，请先确认账户的统计日期口径，不要自行按本地时区换算边界。阅读响应
account、period 和 usage 三部分，结构与示例见下方“返回响应”。| 对象 | 内容 |
|---|---|
account | 账户状态、到期信息与并发/请求配置等返回信息 |
period | 本次查询的起止范围 |
usage | 总用量及模型、功能维度的统计 |
usage.used_minutes 为已使用分钟数。模型项包括 echo_v1、lexis_v1、echo_v1_realtime 和 echo_v2_medical；功能项包括 hotwords 与 content_detection。不同维度可能存在重叠，不要直接相加作为总用量或自行换算费用。usage_quota 可能为 null；客户端应保留其含义，不要把 null 自动解释为零额度或无限额度。统计与计费
错误处理
请求参数
Query 参数
Header 参数
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.myvocal.ai/asr/v1/usage?start_date=2026%2F10%2F13&end_date=2026%2F10%2F13' \
--header 'API-Key: YOUR_API_KEY'响应示例响应示例
{
"account": {
"user_id": "EXAMPLE_ACCOUNT",
"status": "EXAMPLE_STATUS",
"expire_at": "2030-01-01T00:00:00Z",
"qps": 1
},
"period": {
"start": "2026/10/13",
"end": "2026/10/13"
},
"usage": {
"content_detection": 0,
"echo_v1": 0,
"echo_v1_realtime": 0,
"echo_v2_medical": 0,
"hotwords": 0,
"lexis_v1": 0,
"usage_quota": null,
"used_minutes": 0
}
}