Skip to content

Quotas

Monitor and manage resource usage quotas across all services. Quotas define the maximum amount of resources a user can consume within a specific period (e.g., monthly transcription minutes, total storage).

Base path: /api/v1/quotas

Method Endpoint Description
GET /api/v1/quotas Get My Quotas

Get My Quotas

GET /api/v1/quotas

Requires Authentication

Returns the authenticated user's effective quota limits and current usage across all services. Values reflect any user-level overrides applied by an administrator, falling back to tenant or subscription plan defaults.

curl -X GET "https://koldan.dixilang.com/api/v1/quotas" \
  -H "X-API-Key: $KOLDAN_API_KEY"

import requests

resp = requests.get(
    "https://koldan.dixilang.com/api/v1/quotas",
    headers={"Authorization": f"Bearer {JWT}"}
)
print(resp.json())
QuotasResponse
Field Type Nullable Description
speech-service SpeechServiceQuotas No Quota usage for Speech Services.
speaker-service SpeakerServiceQuotas No Quota usage for Speaker Services.
text-service TextServiceQuotas No Quota usage for Text Services.
SpeechServiceQuotas
Field Type Nullable Description
storage QuotaEntry No Total storage quota (bytes). Includes both original media files and their listening audio MP3 derivatives.
transcription QuotaEntry No Monthly transcription minutes (includes offline jobs and online streaming sessions).
summaries QuotaEntry No Monthly summary requests.
summaryTokens QuotaEntry No Monthly summary tokens (total LLM tokens).
SpeakerServiceQuotas
Field Type Nullable Description
monthlyVerifications QuotaEntry No Monthly synchronous speaker verification requests. Default limit: 10000.
monthlyEnrollments QuotaEntry No Monthly speaker enrollment creation requests. Default limit: 1000.
biometricStorage QuotaEntry No Retained speaker biometric storage in bytes. Default limit: 2147483648.
speakers QuotaEntry No Active speaker object count. Default limit: 10000.
TextServiceQuotas
Field Type Nullable Description
textTranslations QuotaEntry No Monthly Translation requests, including transcription translations. Default: 10000.
textTranslationTokens QuotaEntry No Monthly Translation tokens. Default: 5000000; currently input Unicode code points.
QuotaEntry
Field Type Nullable Description
limit long No The maximum allowed value for this quota type.
used long No The current usage for this quota type.
reserved long No Capacity reserved by admitted, unfinished translations (zero for other quotas).
available long No Remaining amount after used and reserved capacity.
QuotasResponse
{
  "speech-service": {
    "storage": {
      "limit": 10737418240,
      "used": 3221225472,
      "available": 7516192768
    },
    "transcription": {
      "limit": 600,
      "used": 120,
      "available": 480
    },
    "summaries": {
      "limit": 100,
      "used": 5,
      "available": 95
    },
    "summaryTokens": {
      "limit": 1000000,
      "used": 45000,
      "available": 955000
    }
  },
  "speaker-service": {
    "monthlyVerifications": {
      "limit": 10000,
      "used": 240,
      "available": 9760
    },
    "monthlyEnrollments": {
      "limit": 1000,
      "used": 12,
      "available": 988
    },
    "biometricStorage": {
      "limit": 2147483648,
      "used": 104857600,
      "available": 2042626048
    },
    "speakers": {
      "limit": 10000,
      "used": 25,
      "available": 9975
    }
  },
  "text-service": {
    "textTranslations": {
      "limit": 10000,
      "used": 50,
      "reserved": 2,
      "available": 9948
    },
    "textTranslationTokens": {
      "limit": 5000000,
      "used": 200000,
      "reserved": 15000,
      "available": 4785000
    }
  }
}
Status Description
200 OK Effective quota limits and usage retrieved.
401 Unauthorized Missing or invalid authentication.