Skip to content

Rate Limits

Monitor and manage API rate limits across all services. Rate limits define the maximum number of requests a user or tenant can make within a specific time window to ensure service stability and fair usage. Base path: /api/v1/rate-limits

Method Endpoint Description
GET /api/v1/rate-limits Get My Rate Limits

Get My Rate Limits

GET /api/v1/rate-limits

Requires Authentication

Returns the authenticated user's effective rate limits 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/rate-limits" \
  -H "X-API-Key: $KOLDAN_API_KEY"

import requests

resp = requests.get(
    "https://koldan.dixilang.com/api/v1/rate-limits",
    headers={"Authorization": f"Bearer {JWT}"}
)
print(resp.json())
RateLimitsResponse
Field Type Nullable Description
speech-service SpeechServiceRateLimits Yes Rate limits for Speech Services.
speaker-service SpeakerServiceRateLimits Yes Rate limits for Speaker Services.
text-service TextServiceRateLimits Yes Rate limits for Text Services.
users UsersServiceRateLimits Yes Rate limits for Users operations.
globalRequests integer Yes Maximum total API requests per minute across all endpoints.
SpeechServiceRateLimits
Field Type Nullable Description
fileUploads integer Yes Maximum file upload requests per minute.
transcriptionJobExecutions integer Yes Maximum transcription job creation requests per minute.
summaryExecutions integer Yes Maximum summary creation requests per minute.
translationExecutions integer Yes Maximum translation creation requests per minute.
speechServiceStreamSessionStarts integer Yes Maximum streaming session start requests per minute.
speechServiceStreamMaxConcurrentSessions integer Yes Maximum concurrent streaming sessions per user.
speechServiceStreamMaxSessionDurationSeconds integer Yes Maximum streaming session duration in seconds.
speechServiceStreamMaxBytesPerSecond integer Yes Maximum audio bytes per second for streaming.
speechServiceFileDownloadBytesPerSecond integer Yes Maximum file download speed in bytes per second.
SpeakerServiceRateLimits
Field Type Nullable Description
speakerEnrollmentCreations integer Yes Maximum speaker enrollment creation requests per minute. Default: 10.
speakerVerificationExecutions integer Yes Maximum speaker verification requests per minute. Default: 60.
speakerVoicePrintPreviews integer Yes Maximum voice-print quality preview requests per minute. Default: 10.
speakerVoicePrintCreations integer Yes Maximum voice-print creation requests per minute. Default: 10.
speakerVoicePrintRebuildStarts integer Yes Reserved for future voice-print rebuild starts per user every 60 minutes. Default: 1.
speakerRecordingDownloads integer Yes Maximum speaker recording downloads per minute. Default: 30.
TextServiceRateLimits
Field Type Nullable Description
textTranslationExecutions integer Yes Maximum on-demand text translation requests per minute.
UsersServiceRateLimits
Field Type Nullable Description
userLookup integer Yes Maximum user lookup requests per minute.
RateLimitsResponse
{
  "speech-service": {
    "fileUploads": 20,
    "transcriptionJobExecutions": 20,
    "summaryExecutions": 30,
    "translationExecutions": 30,
    "speechServiceStreamSessionStarts": 10,
    "speechServiceStreamMaxConcurrentSessions": 1,
    "speechServiceStreamMaxSessionDurationSeconds": 900,
    "speechServiceStreamMaxBytesPerSecond": 35000,
    "speechServiceFileDownloadBytesPerSecond": 5242880
  },
  "speaker-service": {
    "speakerEnrollmentCreations": 10,
    "speakerVerificationExecutions": 60,
    "speakerVoicePrintPreviews": 10,
    "speakerVoicePrintCreations": 10,
    "speakerVoicePrintRebuildStarts": 1,
    "speakerRecordingDownloads": 30
  },
  "text-service": {
    "textTranslationExecutions": 60
  },
  "users": {
    "userLookup": 30
  },
  "globalRequests": 600
}
Status Description
200 OK Effective rate limits retrieved.
401 Unauthorized Missing or invalid authentication.

Data Models

These models are used in individual user rate limit responses.

SpeechServiceRateLimits

Used to define the maximum request rates for Speech Service operations.

Field Type Nullable Description
fileUploads integer Yes Maximum file upload requests per minute.
transcriptionJobExecutions integer Yes Maximum transcription job creation requests per minute.
summaryExecutions integer Yes Maximum summary creation requests per minute.
translationExecutions integer Yes Maximum translation creation requests per minute.
speechServiceStreamSessionStarts integer Yes Maximum streaming session start requests per minute.
speechServiceStreamMaxConcurrentSessions integer Yes Maximum concurrent streaming sessions per user.
speechServiceStreamMaxSessionDurationSeconds integer Yes Maximum streaming session duration in seconds.
speechServiceStreamMaxBytesPerSecond integer Yes Maximum audio bytes per second for streaming.
speechServiceFileDownloadBytesPerSecond integer Yes Maximum file download speed in bytes per second.

SpeakerServiceRateLimits

Used to define the maximum request rates for Speaker Services operations.

Field Type Nullable Description
speakerEnrollmentCreations integer Yes Maximum speaker enrollment creation requests per minute.
speakerVerificationExecutions integer Yes Maximum synchronous speaker verification requests per minute.
speakerVoicePrintPreviews integer Yes Maximum voice-print quality preview requests per minute.
speakerVoicePrintCreations integer Yes Maximum voice-print creation requests per minute.
speakerVoicePrintRebuildStarts integer Yes Reserved for future voice-print rebuild starts per user every 60 minutes.
speakerRecordingDownloads integer Yes Maximum speaker recording downloads per minute.

TextServiceRateLimits

Used to define the maximum request rates for Text Service operations.

Field Type Nullable Description
textTranslationExecutions integer Yes Maximum on-demand text translation requests per minute.

UsersServiceRateLimits

Used to define the maximum request rates for User-related operations.

Field Type Nullable Description
userLookup integer Yes Maximum user lookup requests per minute.