[OpenAI] Refactor project structure (#25986)

* Somehow after compiling the examples are gone

* Renamed model files

* Re-structured project

* Added fix for example directory

* Corrected example

* Corrected documentation issue

* Added new word to custom-word list

Author: jpalvarezl

custom-words.txt

@@ -967,6 +967,7 @@ findsquare
 finetune
 finetunes
 firmwares
+flac
 flexera
 flink
 flowlet
@@ -1644,6 +1645,7 @@ moodle
 mooncake
 mountainview
 movere
+mpga
 mpls
 mpns
 mran

specification/cognitiveservices/OpenAI.Inference/examples/2023-09-01-preview/audio_transcription_object.json

@@ -4,7 +4,8 @@
   "parameters": {
     "endpoint": "{endpoint}",
     "api-version": "2023-09-01-preview",
-    "deploymentId": "<deployment-id>"
+    "deploymentId": "<deployment-id>",
+    "body": "---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"
   },
   "responses": {
     "200": {

specification/cognitiveservices/OpenAI.Inference/main.tsp

@@ -1,11 +1,14 @@
-import "@typespec/rest";
 import "@typespec/http";
 import "@typespec/versioning";
 
-import "./routes.tsp";
+import "./routes/common.tsp";
+import "./routes/audio_transcription.tsp";
+import "./routes/audio_translation.tsp";
+import "./routes/completions.tsp";
+import "./routes/images.tsp";
+import "./routes/embeddings.tsp";
 
 using TypeSpec.Http;
-using TypeSpec.Rest;
 using TypeSpec.Versioning;
 
 #suppress "@azure-tools/typespec-azure-core/casing-style" "OpenAI is a case-sensitive name"
@@ -56,13 +59,3 @@ enum ServiceApiVersions {
   @useDependency(Azure.Core.Versions.v1_0_Preview_1)
   v2023_09_01_Preview: "2023-09-01-preview",
 }
-
-@doc("A specific deployment")
-@TypeSpec.Rest.resource("deployments")
-model Deployment {
-  @visibility("read")
-  @doc("Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.")
-  @projectedName("java", "deploymentOrModelName")
-  @key
-  deploymentId: string;
-}

…Inference/models/audio.transcription.tsp …nce/models/audio/audio_transcription.tspspecification/cognitiveservices/OpenAI.Inference/models/audio.transcription.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/audio/audio_transcription.tsp specification/cognitiveservices/OpenAI.Inference/models/audio.transcription.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/audio/audio_transcription.tsp

@@ -1,5 +1,5 @@
 import "@typespec/versioning";
-import "./audio.common.tsp";
+import "./common.tsp";
 
 namespace Azure.OpenAI;
 
@@ -36,7 +36,7 @@ The configuration information for an audio transcription request.
 model AudioTranscriptionOptions {
   @doc("""
   The audio data to transcribe. This must be the binary content of a file in one of the supported media formats:
-  flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm.
+   flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm.
   """)
   @projectedName("csharp", "AudioData")
   file: bytes;

…I.Inference/models/audio.translation.tsp …rence/models/audio/audio_translation.tspspecification/cognitiveservices/OpenAI.Inference/models/audio.translation.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/audio/audio_translation.tsp specification/cognitiveservices/OpenAI.Inference/models/audio.translation.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/audio/audio_translation.tsp

@@ -1,5 +1,5 @@
 import "@typespec/versioning";
-import "./audio.common.tsp";
+import "./common.tsp";
 
 namespace Azure.OpenAI;
 
@@ -36,7 +36,7 @@ The configuration information for an audio translation request.
 model AudioTranslationOptions {
   @doc("""
   The audio data to translate. This must be the binary content of a file in one of the supported media formats:
-  flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm.
+   flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm.
   """)
   @projectedName("csharp", "AudioData")
   file: bytes;

…OpenAI.Inference/models/audio.common.tsp …OpenAI.Inference/models/audio/common.tspspecification/cognitiveservices/OpenAI.Inference/models/audio.common.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/audio/common.tsp specification/cognitiveservices/OpenAI.Inference/models/audio.common.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/audio/common.tsp

@@ -1,6 +1,7 @@
 import "@typespec/versioning";
-import "./chat.completions.tsp";
-import "./azure.cognitive.search.options.tsp";
+
+import "./chat_completions.tsp";
+import "./azure_cognitive_search_options.tsp";
 
 namespace Azure.OpenAI;
 

…ference/models/azure.chat.extensions.tsp …ls/completions/azure_chat_extensions.tspspecification/cognitiveservices/OpenAI.Inference/models/azure.chat.extensions.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/completions/azure_chat_extensions.tsp specification/cognitiveservices/OpenAI.Inference/models/azure.chat.extensions.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/completions/azure_chat_extensions.tsp

@@ -1,5 +1,6 @@
 import "@typespec/versioning";
-import "./azure.chat.extensions.tsp";
+
+import "./azure_chat_extensions.tsp";
 
 namespace Azure.OpenAI;
 

…odels/azure.cognitive.search.options.tsp …tions/azure_cognitive_search_options.tspspecification/cognitiveservices/OpenAI.Inference/models/azure.cognitive.search.options.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/completions/azure_cognitive_search_options.tsp specification/cognitiveservices/OpenAI.Inference/models/azure.cognitive.search.options.tsp renamed to specification/cognitiveservices/OpenAI.Inference/models/completions/azure_cognitive_search_options.tsp

@@ -1,8 +1,9 @@
 import "@typespec/rest";
 import "@typespec/http";
 import "@typespec/versioning";
-import "./azure.chat.extensions.tsp";
-import "./completions.common.tsp";
+
+import "./azure_chat_extensions.tsp";
+import "./common.tsp";
 import "./functions.tsp";
 
 using TypeSpec.Rest;
@@ -231,8 +232,8 @@ model ChatChoice {
   delta?: ChatMessage;
 
   @doc("""
-    Information about the content filtering category (hate, sexual, violence, self_harm), if it 
-    has been detected, as well as the severity level (very_low, low, medium, high-scale that 
+    Information about the content filtering category (hate, sexual, violence, self_harm), if it
+    has been detected, as well as the severity level (very_low, low, medium, high-scale that
     determines the intensity and risk level of harmful content) and if it has been filtered or not.
     """)
   @added(ServiceApiVersions.v2023_06_01_Preview)
@@ -268,7 +269,7 @@ model ChatCompletions {
   choices: ChatChoice[];
 
   @doc("""
-  Content filtering results for zero or more prompts in the request. In a streaming request, 
+  Content filtering results for zero or more prompts in the request. In a streaming request,
   results for different prompts may arrive at different times or in different orders.
   """)
   @added(ServiceApiVersions.v2023_06_01_Preview)