feat(genapis): add audio transcriptions api

Author: RoRoJ

pages/generative-apis/how-to/query-audio-models.mdx

@@ -12,7 +12,7 @@ Scaleway's Generative APIs service allows users to interact with powerful audio
 
 There are several ways to interact with audio models:
 - The Scaleway [console](https://console.scaleway.com) provides a complete [playground](/generative-apis/how-to/query-language-models/#accessing-the-playground), aiming to test models, adapt parameters, and observe how these changes affect the output in real-time.
-- Via the [Chat Completions API](https://www.scaleway.com/en/developers/api/generative-apis/#path-chat-completions-create-a-chat-completion) or the [Audio Transcriptions API](https://www.scaleway.com/en/developers/api/generative-apis/#path-TODO)
+- Via the [Chat Completions API](https://www.scaleway.com/en/developers/api/generative-apis/#path-chat-completions-create-a-chat-completion) or the [Audio Transcriptions API](https://www.scaleway.com/en/developers/api/generative-apis/#path-audio-create-an-audio-transcription)
 
 <Requirements />
 
@@ -21,7 +21,7 @@ There are several ways to interact with audio models:
 - A valid [API key](/iam/how-to/create-api-keys/) for API authentication
 - Python 3.7+ installed on your system
 
-## Accessing the Playground
+## Accessing the playground
 
 Scaleway provides a web playground for instruct-based models hosted on Generative APIs.
 
@@ -48,14 +48,14 @@ In the example that follows, we will use the OpenAI Python client.
 
 ### Chat Completions API or Audio Transcriptions API?
 
-Both the [Chat Completions API](TODO) and the [Audio Transcriptions API](TODO) are OpenAI-compatible REST APIs that accept audio input.
+Both the [Chat Completions API](https://www.scaleway.com/en/developers/api/generative-apis/#path-chat-completions-create-a-chat-completion) and the [Audio Transcriptions API](https://www.scaleway.com/en/developers/api/generative-apis/#path-audio-create-an-audio-transcription) are OpenAI-compatible REST APIs that accept audio input.
 
-The **Chat Completions API** is more suitable when transcribing audio input is part of a broader task, rather than pure transcription. Examples could include building a voice chat assistant which listens and responds in natural language, or sending multiple inputs (audio and text) to be interpreted and commented on. This API can be used with compatible multimodal models, such as `voxtral-small-24b`.
+The **Chat Completions API** is more suitable when transcribing audio input is part of a broader task, rather than a pure transcription task. For example, building a voice chat assistant which listens and responds in natural language, or sending multiple inputs (audio and text) to be interpreted. This API can be used for audio tasks with compatible multimodal models, such as `voxtral-small-24b`.
 
 The **Audio Transcriptions API** is designed for pure speech-to-text (audio transcription) tasks, such as transcribing a voice note or meeting recording file. It can be used with compatible audio models, such as `whisper-large-v3`.
 
 <Message type="note">
-Scaleway's support for the Audio Transcriptions API is currently at beta stage. TODO CHECK: incremental support of feature set?
+Scaleway's support for the Audio Transcriptions API is currently at beta stage. Support of the full feature set will be incremental.
 </Message>
 
 For full details on the differences between these APIs, see the [official OpenAI documentation](https://platform.openai.com/docs/guides/audio#choosing-the-right-api).
@@ -88,28 +88,30 @@ You can now generate a text transcription of a given audio file using a suitable
 
 <Tabs id="transcribing-audio">
 
-    <TabsTab label="Audio Transcriptions API">
+    <TabsTab label="Audio Transcriptions API (Beta)">
+    
+    <Message type="note">
+    The Audio Transcriptions API expects audio files to be found locally. It does not support passing the URL of a remote audio file.
+    </Message>
 
-    from openai import OpenAI
-    import os
-
-    client = OpenAI(
-        base_url="https://aa2cee79-0e20-4515-8ec0-0a8084dfbd9e.ifr.fr-par.scaleway.com/v1",
-        api_key=os.getenv("SCW_SECRET_KEY")  # Your unique API secret key from Scaleway
-    )
+    In the example below, a local audio file [scaleway-ai-revolution.mp3](https://genapi-documentation-assets.s3.fr-par.scw.cloud/scaleway-ai-revolution.mp3) is sent to the model. The resulting text transcription is printed to the screen.
 
+    ```python
     MODEL = "openai/whisper-large-v3:fp16"
-    AUDIO = 'interview-jbk-62s.mp3'
+    AUDIO = 'scaleway-ai-revolution.mp3'
 
     audio_file = open(AUDIO, "rb")
 
     response = client.audio.transcriptions.create(
         model=MODEL,
         file=audio_file,
-        language='fr'
+        language='en'
     )
 
     print(response.text)
+    ```
+
+    See the [dedicated API documentation](https://www.scaleway.com/en/developers/api/generative-apis/#path-audio-create-an-audio-transcription) for a full list of all available parameters.
 
     </TabsTab>
 
@@ -161,7 +163,7 @@ You can now generate a text transcription of a given audio file using a suitable
     print(response.choices[0].message.content)
     ```
 
-    Various parameters such as `temperature` and `max_tokens` control the output. See the [dedicated API documentation](https://www.scaleway.com/en/developers/api/generative-apis/#path-chat-completions-create-a-chat-completion) for a full list of all available parameters.
+    See the [dedicated API documentation](https://www.scaleway.com/en/developers/api/generative-apis/#path-chat-completions-create-an) for a full list of all available parameters.
 
     #### Transcribing a local audio file