v1

latestOpenAPI 3.0.32026-07-265278189.1 KB
MetaInformation

Check Usage and Limits

get/v2/usage

Response

The account's usage and limits.

character_countinteger

Characters translated so far in the current billing period.

character_limitinteger

Current maximum number of characters that can be translated per billing period. If cost control is set, the cost control limit will be returned in this field.

document_countinteger

Documents translated so far in the current billing period. Only present for accounts with a document limit.

document_limitinteger

Current maximum number of documents that can be translated per billing period. Only present for accounts with a document limit.

team_document_countinteger

Documents translated by all users in the team so far in the current billing period. Only present for accounts with a team document limit.

team_document_limitinteger

Current maximum number of documents that can be translated by the team per billing period. Only present for accounts with a team document limit.

api_key_character_countinteger

Only present for API Pro users. Total characters used by this API key in the current period.

api_key_character_limitinteger

Only present for API Pro users. Character limit for this API key in the current period.

speech_to_text_milliseconds_countinteger

Deprecated. Always returns 0. Use speech_to_text_minutes_count instead.

speech_to_text_milliseconds_limitinteger

Deprecated. Always returns 0. Use speech_to_text_minutes_limit instead.

speech_to_text_minutes_countinteger

Only present for API Pro users. Minutes of speech-to-text used in the current period. Milliseconds are rounded up to the nearest minute.

speech_to_text_minutes_limitinteger

Only present for API Pro users. Maximum minutes of speech-to-text that can be used in the current billing period.

speech_to_speech_minutes_countinteger

Only present for API Pro users. Minutes of speech-to-speech used in the current period. Milliseconds are rounded up to the nearest minute.

speech_to_speech_minutes_limitinteger

Only present for API Pro users. Maximum minutes of speech-to-speech that can be used in the current billing period.

start_timestring date-time

Only present for API Pro users. Start time of the current billing period (ISO 8601).

end_timestring date-time

Only present for API Pro users. End time of the current billing period (ISO 8601).

Example response

{
  "character_count": 180118,
  "character_limit": 1250000,
  "products": [
    {
      "product_type": "write",
      "billing_unit": "characters",
      "account_unit_count": 5643,
      "character_count": 5643
    }
  ],
  "api_key_character_count": 636,
  "api_key_character_limit": 1000000000000,
  "speech_to_text_minutes_count": 30,
  "speech_to_text_minutes_limit": 600,
  "speech_to_speech_minutes_count": 12,
  "speech_to_speech_minutes_limit": 600,
  "start_time": "2025-05-13T09:18:42Z",
  "end_time": "2025-06-13T09:18:42Z"
}