|
| 1 | +--- |
| 2 | +title: "DeepL Voice API Service Specification Updates" |
| 3 | +--- |
| 4 | + |
| 5 | + |
| 6 | +**In the section “Definitions” the following definition will be added:** |
| 7 | + * **“Audio Minutes”** refers to the total duration of audio data streamed through the API, measured in minutes. The calculation of audio minutes is based on the actual playback duration of the audio content, regardless of the speed at which the audio data is transmitted. The duration of audio content is determined by its standard playback speed, which is defined as 1x (normal speed). If audio data is streamed at an accelerated rate, up to a maximum speed allowed in the Documentation, the Audio Minutes are still calculated based on the standard playback duration. |
| 8 | + |
| 9 | +**In the section “Remuneration” the following paragraph will be added:** |
| 10 | + * Deviating from the DeepL API Pro for translating or improving text, the DeepL API Pro for speech to text charges Customer based on the total Audio Minutes streamed, irrespective of the connection duration or the speed of transmission. Any fractional Audio Minutes will be rounded up to the nearest whole minute for billing purposes. |
| 11 | + |
| 12 | +**In the DeepL Pro Service Specification for the DeepL API Pro and DeepL API Free the following will be added:** |
| 13 | + |
| 14 | +The DeepL API Pro (v3 endpoint only) also includes a speech-to-text translation function for realtime audio. This function is only available to users with a DeepL API Pro subscription type. The speech-to-text function for realtime audio provides the following functionality: |
| 15 | + |
| 16 | +<table> |
| 17 | + <thead></thead> |
| 18 | + <tbody> |
| 19 | + <tr> |
| 20 | + <td>Audio Stream</td> |
| 21 | + <td>Realtime Audio stream to be translated into text in up to 5 languages.</td> |
| 22 | + </tr> |
| 23 | + <tr> |
| 24 | + <td>Input Languages (Audio)</td> |
| 25 | + <td> |
| 26 | + <p>The realtime audio stream you want to have translated can be in one of the following languages:</p> |
| 27 | + <ul> |
| 28 | + <li>`CS` (Czech)</li> |
| 29 | + <li>`DE` (German)</li> |
| 30 | + <li>`EN` (English)</li> |
| 31 | + <li>`ES` (Spanish)</li> |
| 32 | + <li>`FR` (French)</li> |
| 33 | + <li>`ID` (Indonesian)</li> |
| 34 | + <li>`IT` (Italian)</li> |
| 35 | + <li>`JA` (Japanese)</li> |
| 36 | + <li>`KO` (Korean)</li> |
| 37 | + <li>`NL` (Dutch)</li> |
| 38 | + <li>`PL` (Polish)</li> |
| 39 | + <li>`PT` (Portuguese)</li> |
| 40 | + <li>`RO` (Romanian)</li> |
| 41 | + <li>`RU` (Russian)</li> |
| 42 | + <li>`SV` (Swedish)</li> |
| 43 | + <li>`TR` (Turkish)</li> |
| 44 | + <li>`UK` (Ukrainian)</li> |
| 45 | + <li>`ZH` (Chinese)</li> |
| 46 | + </ul> |
| 47 | + </td> |
| 48 | + </tr> |
| 49 | + <tr> |
| 50 | + <td>Target language (Text)</td> |
| 51 | + <td> |
| 52 | + <p>The language in which your translations are provided can be one of the following:</p> |
| 53 | + <ul> |
| 54 | + <li>`AR` (Arabic)</li> |
| 55 | + <li>`BG` (Bulgarian)</li> |
| 56 | + <li>`CS` (Czech)</li> |
| 57 | + <li>`DA` (Danish)</li> |
| 58 | + <li>`DE` (German)</li> |
| 59 | + <li>`EL` (Greek)</li> |
| 60 | + <li>`EN-GB` (British-British)</li> |
| 61 | + <li>`EN-US` (American-English)</li> |
| 62 | + <li>`ES` (Spanish)</li> |
| 63 | + <li>`ET` (Estonian)</li> |
| 64 | + <li>`FI` (Finnish)</li> |
| 65 | + <li>`FR` (French)</li> |
| 66 | + <li>`HE` (Hebrew)</li> |
| 67 | + <li>`HU` (Hungarian)</li> |
| 68 | + <li>`ID` (Indonesian)</li> |
| 69 | + <li>`IT` (Italian)</li> |
| 70 | + <li>`JA` (Japanese)</li> |
| 71 | + <li>`KO` (Korean)</li> |
| 72 | + <li>`LI` (Lithuanian)</li> |
| 73 | + <li>`LV` (Latvian)</li> |
| 74 | + <li>`NL` (Dutch)</li> |
| 75 | + <li>`NO` (Norwegian)</li> |
| 76 | + <li>`PL` (Polish)</li> |
| 77 | + <li>`PT-PT` (Portuguese) (all Portuguese varieties excluding Brazilian Portuguese)</li> |
| 78 | + <li>`PT-BR` (Brazilian Portuguese)</li> |
| 79 | + <li>`PT` (Portuguese) (unspecified variant for backward compatibility; please select `PT-PT` or `PT-BR` instead)</li> |
| 80 | + <li>`RO` (Romanian)</li> |
| 81 | + <li>`RU` (Russian)</li> |
| 82 | + <li>`SK` (Slovak)</li> |
| 83 | + <li>`SL` (Slovenian)</li> |
| 84 | + <li>`SV` (Swedish)</li> |
| 85 | + <li>`TR` (Turkish)</li> |
| 86 | + <li>`UK` (Ukrainian)</li> |
| 87 | + <li>`VI` (Vietnamese)</li> |
| 88 | + <li>`ZH-HANS` (Chinese (simplified))</li> |
| 89 | + <li>`ZH-HANT` (Chinese (traditional))</li> |
| 90 | + </ul> |
| 91 | + </td> |
| 92 | + </tr> |
| 93 | + </tbody> |
| 94 | +</table> |
| 95 | + |
| 96 | +The speech to text function returns the following representation of the processing result: |
| 97 | + |
| 98 | +<table> |
| 99 | + <thead></thead> |
| 100 | + <tbody> |
| 101 | + <tr> |
| 102 | + <td>Language</td> |
| 103 | + <td>The language which has been detected for your audio.</td> |
| 104 | + </tr> |
| 105 | + <tr> |
| 106 | + <td>Text</td> |
| 107 | + <td>The translated text(s) and the transcribed source as a text.</td> |
| 108 | + </tr> |
| 109 | + </tbody> |
| 110 | +</table> |
| 111 | + |
| 112 | +The DeepL API Pro for speech to text is designed to process a specific amount of target languages per stream for a specific maximum streaming connection duration and audio chunk size. The exact applicable information and units can be found in the Documentation. The audio stream speed shall not exceed two times real time; exceeding use may be limited, and Customers may encounter a 429 “Too Many Requests” error message, as described in the documentation. |
| 113 | + |
| 114 | +Applications using the DeepL API Pro should implement a mechanism to handle such responses accordingly and, if appropriate, to try again later. A mechanism increasing the delay for another request exponentially is recommended. |
| 115 | + |
| 116 | +**Amazon Web Services EMEA SARL will be added as a new sub-processor to the Data Processing Agreement. The following new section will apply:** |
| 117 | + |
| 118 | +When using the DeepL API Pro speech to text v3 endpoint specific languages will be processed through AWS Transcribe. These languages are currently not set out above and will be explicitly mentioned in our Help Center. DeepL will be available to add these additional languages for the service by leveraging the real-time transcription capabilities of the Amazon Transcribe API. DeepL has concluded a data processing agreement (“DPA”) with Amazon Web Services EMEA SARL (“AWS) and therefore AWS may only process the data according to DeepL’s instructions and not for their own purposes. When using the v3 endpoint, Customer accepts and agrees that – in case of an existing DPA with DeepL – this DPA will be amended to this regard that AWS will be added as new sub-processors. |
0 commit comments