Merge pull request #259 from DeepLcom/usage-analytics-stt

Add STT usage in minutes to docs and spec

Author: lilkraftwerk

api-reference/admin-api/organization-usage-analytics.mdx

@@ -35,11 +35,12 @@ The optional `group_by` parameter allows you to organize usage data in different
 
 ### Usage breakdown
 
-All responses include a breakdown of character usage by service type:
+All responses include a breakdown of usage by service type:
 * **Total characters**: Combined usage across all services
 * **Text translation characters**: Characters used for text translation
 * **Document translation characters**: Characters used for document translation
 * **Text improvement characters**: Characters used for text improvement (rephrasing)
+* **Speech-to-text minutes**: Duration of speech-to-text usage in minutes
 
 ## Use cases
 

api-reference/openapi.yaml

@@ -138,7 +138,7 @@ paths:
                         text_translation_characters: 4892
                         document_translation_characters: 0
                         text_improvement_characters: 4727
-                        speech_to_text_milliseconds: 1800000
+                        speech_to_text_minutes: 107.46
                       group_by: "key_and_day"
                       start_date: "2025-09-29T00:00:00"
                       end_date: "2025-10-01T00:00:00"
@@ -151,7 +151,7 @@ paths:
                           text_translation_characters: 159
                           document_translation_characters: 0
                           text_improvement_characters: 156
-                          speech_to_text_milliseconds: 1800000
+                          speech_to_text_minutes: 11.94
                 withoutGrouping:
                   summary: Usage report without grouping
                   value:
@@ -161,7 +161,7 @@ paths:
                         text_translation_characters: 4892
                         document_translation_characters: 0
                         text_improvement_characters: 4727
-                        speech_to_text_milliseconds: 1800000
+                        speech_to_text_minutes: 107.46
                       start_date: "2025-09-29T00:00:00"
                       end_date: "2025-10-01T00:00:00"
         400:
@@ -4688,10 +4688,10 @@ components:
           type: integer
           description: Number of characters used for text improvement.
           example: 4727
-        speech_to_text_milliseconds:
-          type: integer
-          description: Duration of speech-to-text usage in milliseconds.
-          example: 1800000
+        speech_to_text_minutes:
+          type: number
+          description: Duration of speech-to-text usage in minutes.
+          example: 107.46
     KeyAndDayUsageItem:
       type: object
       description: Usage statistics for a specific API key and optionally a specific date.