Merge pull request #167 from DeepLcom/acl/acl-2168-voice-v3

[ACL-2168] change voice v1 to v3

Author: sj-dl

api-reference/openapi.yaml

@@ -1932,7 +1932,7 @@ paths:
           $ref: '#/components/responses/ServiceUnavailable'
       security:
       - auth_header: []
-  /v1/voice/realtime:
+  /v3/voice/realtime:
     post:
       tags:
         - VoiceAPI
@@ -1984,7 +1984,7 @@ paths:
               schema:
                 $ref: '#/components/schemas/VoiceStreamingResponse'
               example:
-                streaming_url: 'wss://api.deepl.com/v1/voice/realtime/connect'
+                streaming_url: 'wss://api.deepl.com/v3/voice/realtime/connect'
                 token: 'VGhpcyBpcyBhIGZha2UgdG9rZW4K'
                 session_id: '4f911080-cfe2-41d4-8269-0e6ec15a0354'
         400:
@@ -4298,7 +4298,7 @@ components:
           description: >
             The WebSocket URL to use for establishing
             [the stream connection](/api-reference/voice/websocket-streaming).
-          example: wss://api.deepl.com/v1/voice/realtime/connect
+          example: wss://api.deepl.com/v3/voice/realtime/connect
         token:
           type: string
           description: >

api-reference/voice.mdx

@@ -124,11 +124,11 @@ The Voice API uses a two-step flow to initiate streaming.
 
 <Steps>
   <Step title="Request Stream">
-    Make a POST request `v1/voice/realtime` to obtain an ephemeral streaming URL and authentication token. The response will look like this:
+    Make a POST request `v3/voice/realtime` to obtain an ephemeral streaming URL and authentication token. The response will look like this:
 
     ```json
     {
-      "streaming_url": "wss://api.deepl.com/v1/voice/realtime/connect",
+      "streaming_url": "wss://api.deepl.com/v3/voice/realtime/connect",
       "token": <secure access token>,
     }
     ```
@@ -144,7 +144,7 @@ The Voice API uses a two-step flow to initiate streaming.
     See the [Request Stream](/api-reference/voice/request-stream) documentation for details.
   </Step>
   <Step title="Streaming Audio and Text (WebSocket)">
-    Use the received URL to establish a WebSocket connection to `wss://api.deepl.com/v1/voice/realtime/connect?token=<secure access token>`.
+    Use the received URL to establish a WebSocket connection to `wss://api.deepl.com/v3/voice/realtime/connect?token=<secure access token>`.
     This step handles exchanging JSON messages on the WebSocket connection:
     * Sending audio data
     * Receiving transcriptions and translations in real-time

api-reference/voice/request-stream.mdx

@@ -1,4 +1,4 @@
 ---
-openapi: post /v1/voice/realtime
+openapi: post /v3/voice/realtime
 title: "Request Stream"
 ---

api-reference/voice/voice.asyncapi.yaml

@@ -13,7 +13,7 @@ info:
 servers:
   production:
     host: api.deepl.com
-    pathname: /v1/voice/realtime/connect
+    pathname: /v3/voice/realtime/connect
     protocol: wss
     description: DeepL Voice API WebSocket endpoint.
     variables:
@@ -24,7 +24,7 @@ servers:
 
 channels:
   voiceStream:
-    address: /v1/voice/realtime/connect?token={token}
+    address: /v3/voice/realtime/connect?token={token}
     description: >
         WebSocket channel for streaming audio and receiving transcriptions and translations.
         Messages are exchanged in JSON format and WebSocket frames must be of type TEXT.