Developer platform
Get remaining usage
Reads the remaining allowance. A voice key (vc_sk_live_*) gets the account quota plus its own ceiling. An admin key (vc_ak_live_*) reads only its own ceiling, never the account quota.
GET
/api/v1/usageOn this page
Code examples
# Voice key: quota tài khoản + hạn mức của chính key đó
curl https://studio.evomlabs.com/api/v1/usage \
-H "Authorization: Bearer vc_sk_live_YOUR_KEY"
# Admin key: CHỈ hạn mức của chính key đó, không có quota tài khoản
curl https://studio.evomlabs.com/api/v1/usage \
-H "Authorization: Bearer vc_ak_live_YOUR_KEY"Response
// vc_sk_live_* (voice key)
{
"ok": true,
"data": {
"environment": "live",
"limit": 500000,
"used": 1234,
"remaining": 498766,
"unlimited": false,
"reset_date": "2026-09-01T00:00:00.000Z",
"reset_interval": "month",
"reset_interval_count": 1,
"key": {
"kind": "tts",
"name": "Landing page voice",
"last_four": "9f2c",
"credit_limit": 200,
"credit_used": 12,
"credit_remaining": 188,
"credit_source": "key",
"spendable": 188
}
}
}
// vc_ak_live_* (admin key): chỉ đọc được hạn mức của chính nó
{
"ok": true,
"data": {
"environment": "live",
"key": {
"kind": "admin",
"name": "Contractor key",
"last_four": "4a71",
"credit_limit": 200,
"credit_used": 12,
"credit_remaining": 188,
"credit_source": "key"
}
}
}
// Admin key không đặt hạn mức riêng: nó tiêu vào quota tài khoản, và con số
// đó không được trả về cho admin key.
{
"ok": true,
"data": {
"environment": "live",
"key": {
"kind": "admin",
"name": "Internal key",
"last_four": "1d09",
"credit_limit": null,
"credit_used": 4820,
"credit_remaining": null,
"credit_source": "account"
}
}
}Request
Send the credential in the Authorization header. Account and voice keys are accepted only where the endpoint contract permits them.
Response
JSON
// vc_sk_live_* (voice key)
{
"ok": true,
"data": {
"environment": "live",
"limit": 500000,
"used": 1234,
"remaining": 498766,
"unlimited": false,
"reset_date": "2026-09-01T00:00:00.000Z",
"reset_interval": "month",
"reset_interval_count": 1,
"key": {
"kind": "tts",
"name": "Landing page voice",
"last_four": "9f2c",
"credit_limit": 200,
"credit_used": 12,
"credit_remaining": 188,
"credit_source": "key",
"spendable": 188
}
}
}
// vc_ak_live_* (admin key): chỉ đọc được hạn mức của chính nó
{
"ok": true,
"data": {
"environment": "live",
"key": {
"kind": "admin",
"name": "Contractor key",
"last_four": "4a71",
"credit_limit": 200,
"credit_used": 12,
"credit_remaining": 188,
"credit_source": "key"
}
}
}
// Admin key không đặt hạn mức riêng: nó tiêu vào quota tài khoản, và con số
// đó không được trả về cho admin key.
{
"ok": true,
"data": {
"environment": "live",
"key": {
"kind": "admin",
"name": "Internal key",
"last_four": "1d09",
"credit_limit": null,
"credit_used": 4820,
"credit_remaining": null,
"credit_source": "account"
}
}
}Errors
REST failures use the documented error envelope. Handle the error code instead of matching the human-readable message.
Error codesWas this page helpful?