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/usage
On 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"
    }
  }
}

Authorization

Bearer credential

Send the credential in the Authorization header. Account and voice keys are accepted only where the endpoint contract permits them.

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 codes

Was this page helpful?

Evom Labs API documentation