Misc. fixes

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -6,30 +6,16 @@ body:
     attributes:
       value: |
         Thanks for taking the time to fill out this bug report!
-  - type: checkboxes
-    id: non_python
+  - type: dropdown
+    id: service-kind
     attributes:
-      label: Confirm this is not an issue with the OpenAI Python Library
-      description: Issues with the OpenAI Python Library should be reported in our [OpenAI Python SDK repo](https://github.com/openai/openai-python/issues)
+      label: Service
+      description: Select whether you are using OpenAI or Azure OpenAI
       options:
-        - label: This is not an issue with the OpenAI Python Library
-          required: true
-  - type: checkboxes
-    id: non_api
-    attributes:
-      label: Confirm this is not an issue with the underlying OpenAI API
-      description: Issues with the underlying OpenAI API should be reported in our [Developer Community](https://community.openai.com/c/api/7)
-      options:
-        - label: This is not an issue with the OpenAI API
-          required: true
-  - type: checkboxes
-    id: non_azure
-    attributes:
-      label: Confirm this is not an issue with Azure OpenAI
-      description: Issues related to Azure OpenAI should be reported in the [Azure SDK repo](https://github.com/Azure/azure-sdk-for-net/issues)
-      options:
-        - label: This is not an issue with Azure OpenAI
-          required: true
+        - OpenAI
+        - Azure OpenAI
+    validations:
+      required: true
   - type: textarea
     id: what-happened
     attributes:
@@ -68,13 +54,11 @@ body:
     id: language-version
     attributes:
       label: .NET version
-      placeholder: 
     validations:
       required: true
   - type: input
     id: lib-version
     attributes:
       label: Library version
-      placeholder: 
     validations:
       required: true

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -9,18 +9,10 @@ body:
   - type: checkboxes
     id: non_api
     attributes:
-      label: Confirm this is not a feature request for the underlying OpenAI API.
-      description: Feature requests for the underlying OpenAI API should be reported in our [Developer Community](https://community.openai.com/c/api/7)
+      label: Confirm this is a feature request for the .NET library and not the underlying OpenAI API.
+      description: Feature requests for the underlying OpenAI API should be reported on our [Developer Community](https://community.openai.com/c/api/7)
       options:
-        - label: This is not a feature request for the underlying OpenAI API
-          required: true
-  - type: checkboxes
-    id: non_azure
-    attributes:
-      label: Confirm this is not a feature request for Azure OpenAI.
-      description: Feature requests for Azure OpenAI should be reported reported in the [Azure SDK repo](https://github.com/Azure/azure-sdk-for-net/issues)
-      options:
-        - label: This is not a feature request for Azure OpenAI
+        - label: This is a feature request for the .NET library
           required: true
   - type: textarea
     id: feature

README.md

@@ -17,7 +17,7 @@ It is generated from our [OpenAPI specification](https://github.com/openai/opena
   - [Using the `OpenAIClient` class](#using-the-openaiclient-class)
 - [How to use chat completions with streaming](#how-to-use-chat-completions-with-streaming)
 - [How to use chat completions with tools and function calling](#how-to-use-chat-completions-with-tools-and-function-calling)
-- [How to use structured outputs](#how-to-use-structured-outputs)
+- [How to use chat completions with structured outputs](#how-to-use-structured-outputs)
 - [How to generate text embeddings](#how-to-generate-text-embeddings)
 - [How to generate images](#how-to-generate-images)
 - [How to transcribe audio](#how-to-transcribe-audio)
@@ -65,19 +65,19 @@ While you can pass your API key directly as a string, it is highly recommended t
 
 The library is organized into several namespaces corresponding to OpenAI feature areas. Each namespace contains a corresponding client class.
 
-| Namespace                     | Client class                 | Notes               |
-| ------------------------------|------------------------------|---------------------|
-| `OpenAI.Assistants`           | `AssistantClient`            | \[Experimental\]    |
-| `OpenAI.Audio`                | `AudioClient`                |                     |
-| `OpenAI.Batch`                | `BatchClient`                |                     |
-| `OpenAI.Chat`                 | `ChatClient`                 |                     |
-| `OpenAI.Embeddings`           | `EmbeddingClient`            |                     |
-| `OpenAI.FineTuning`           | `FineTuningClient`           |                     |
-| `OpenAI.Files`                | `FileClient`                 |                     |
-| `OpenAI.Images`               | `ImageClient`                |                     |
-| `OpenAI.Models`               | `ModelClient`                |                     |
-| `OpenAI.Moderations`          | `ModerationClient`           |                     |
-| `OpenAI.VectorStores`         | `VectorStoreClient`          | \[Experimental\]    |
+| Namespace                     | Client class                 | Notes                                                             |
+| ------------------------------|------------------------------|-------------------------------------------------------------------|
+| `OpenAI.Assistants`           | `AssistantClient`            | ![Experimental](https://img.shields.io/badge/experimental-purple) |
+| `OpenAI.Audio`                | `AudioClient`                |                                                                   |
+| `OpenAI.Batch`                | `BatchClient`                | ![Experimental](https://img.shields.io/badge/experimental-purple) |
+| `OpenAI.Chat`                 | `ChatClient`                 |                                                                   |
+| `OpenAI.Embeddings`           | `EmbeddingClient`            |                                                                   |
+| `OpenAI.FineTuning`           | `FineTuningClient`           | ![Experimental](https://img.shields.io/badge/experimental-purple) |
+| `OpenAI.Files`                | `FileClient`                 |                                                                   |
+| `OpenAI.Images`               | `ImageClient`                |                                                                   |
+| `OpenAI.Models`               | `ModelClient`                |                                                                   |
+| `OpenAI.Moderations`          | `ModerationClient`           |                                                                   |
+| `OpenAI.VectorStores`         | `VectorStoreClient`          | ![Experimental](https://img.shields.io/badge/experimental-purple) |
 
 ### Using the async API
 
@@ -297,7 +297,7 @@ do
 } while (requiresAction);
 ```
 
-## How to use structured outputs
+## How to use chat completions with structured outputs
 
 Beginning with the `gpt-4o-mini`, `gpt-4o-mini-2024-07-18`, and `gpt-4o-2024-08-06` model snapshots, structured outputs are available for both top-level response content and tool calls in the chat completion and assistants APIs.
 

examples/Chat/Example01_SimpleChat.cs

@@ -9,7 +9,7 @@ public partial class ChatExamples
     [Test]
     public void Example01_SimpleChat()
     {
-        ChatClient client = new(model: "gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ChatClient client = new(model: "gpt-4o", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         ChatCompletion completion = client.CompleteChat("Say 'this is a test.'");
 

examples/Chat/Example01_SimpleChatAsync.cs

@@ -10,7 +10,7 @@ public partial class ChatExamples
     [Test]
     public async Task Example01_SimpleChatAsync()
     {
-        ChatClient client = new(model: "gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ChatClient client = new(model: "gpt-4o", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         ChatCompletion completion = await client.CompleteChatAsync("Say 'this is a test.'");
 

examples/Chat/Example02_SimpleChatStreaming.cs

@@ -10,7 +10,7 @@ public partial class ChatExamples
     [Test]
     public void Example02_SimpleChatStreaming()
     {
-        ChatClient client = new(model: "gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ChatClient client = new(model: "gpt-4o", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         CollectionResult<StreamingChatCompletionUpdate> updates
             = client.CompleteChatStreaming("Say 'this is a test.'");

examples/Chat/Example02_SimpleChatStreamingAsync.cs

@@ -11,7 +11,7 @@ public partial class ChatExamples
     [Test]
     public async Task Example02_SimpleChatStreamingAsync()
     {
-        ChatClient client = new(model: "gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ChatClient client = new(model: "gpt-4o", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         AsyncCollectionResult<StreamingChatCompletionUpdate> updates
             = client.CompleteChatStreamingAsync("Say 'this is a test.'");

examples/Chat/Example05_ChatWithVision.cs → examples/Chat/Example05_Vision.cs

@@ -9,7 +9,7 @@ namespace OpenAI.Examples;
 public partial class ChatExamples
 {
     [Test]
-    public void Example05_ChatWithVision()
+    public void Example05_Vision()
     {
         ChatClient client = new("gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 

examples/Chat/Example05_ChatWithVisionAsync.cs → examples/Chat/Example05_VisionAsync.cs

@@ -10,7 +10,7 @@ namespace OpenAI.Examples;
 public partial class ChatExamples
 {
     [Test]
-    public async Task Example05_ChatWithVisionAsync()
+    public async Task Example05_VisionAsync()
     {
         ChatClient client = new("gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 

examples/Chat/Example07_StructuredOutputs.cs → examples/Chat/Example06_StructuredOutputs.cs

@@ -1,17 +1,22 @@
 using NUnit.Framework;
 using OpenAI.Chat;
 using System;
+using System.Collections.Generic;
 using System.Text.Json;
 
 namespace OpenAI.Examples;
 
 public partial class ChatExamples
 {
     [Test]
-    public void Example07_StructuredOutputs()
+    public void Example06_StructuredOutputs()
     {
         ChatClient client = new("gpt-4o-mini", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
+        List<ChatMessage> messages = [
+            new UserChatMessage("How can I solve 8x + 7 = -23?"),
+        ];
+
         ChatCompletionOptions options = new()
         {
             ResponseFormat = ChatResponseFormat.CreateJsonSchemaFormat(
@@ -41,9 +46,7 @@ public void Example07_StructuredOutputs()
                 jsonSchemaIsStrict: true)
         };
 
-        ChatCompletion chatCompletion = client.CompleteChat(
-            [ new UserChatMessage("How can I solve 8x + 7 = -23?") ],
-            options);
+        ChatCompletion chatCompletion = client.CompleteChat(messages, options);
 
         using JsonDocument structuredJson = JsonDocument.Parse(chatCompletion.ToString());
 

examples/Chat/Example07_StructuredOutputsAsync.cs → examples/Chat/Example06_StructuredOutputsAsync.cs

@@ -1,6 +1,7 @@
 using NUnit.Framework;
 using OpenAI.Chat;
 using System;
+using System.Collections.Generic;
 using System.Text.Json;
 using System.Threading.Tasks;
 
@@ -9,10 +10,14 @@ namespace OpenAI.Examples;
 public partial class ChatExamples
 {
     [Test]
-    public async Task Example07_StructuredOutputsAsync()
+    public async Task Example06_StructuredOutputsAsync()
     {
         ChatClient client = new("gpt-4o-mini", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
+        List<ChatMessage> messages = [
+            new UserChatMessage("How can I solve 8x + 7 = -23?"),
+        ];
+
         ChatCompletionOptions options = new()
         {
             ResponseFormat = ChatResponseFormat.CreateJsonSchemaFormat(
@@ -42,9 +47,7 @@ public async Task Example07_StructuredOutputsAsync()
                 jsonSchemaIsStrict: true)
         };
 
-        ChatCompletion chatCompletion = await client.CompleteChatAsync(
-            [ new UserChatMessage("How can I solve 8x + 7 = -23?") ],
-            options);
+        ChatCompletion chatCompletion = await client.CompleteChatAsync(messages, options);
 
         using JsonDocument structuredJson = JsonDocument.Parse(chatCompletion.ToString());
 

examples/Chat/Example07_SimpleChatProtocol.cs → examples/Chat/Example07_ChatProtocol.cs

@@ -9,7 +9,7 @@ namespace OpenAI.Examples;
 public partial class ChatExamples
 {
     [Test]
-    public void Example07_SimpleChatProtocol()
+    public void Example07_ChatProtocol()
     {
         ChatClient client = new("gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 

examples/Chat/Example07_SimpleChatProtocolAsync.cs → examples/Chat/Example07_ChatProtocolAsync.cs

@@ -10,7 +10,7 @@ namespace OpenAI.Examples;
 public partial class ChatExamples
 {
     [Test]
-    public async Task Example07_SimpleChatProtocolAsync()
+    public async Task Example07_ChatProtocolAsync()
     {
         ChatClient client = new("gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 

examples/Chat/Example06_ChatSerialization.cs → examples/Chat/Example08_ChatSerialization.cs

@@ -4,27 +4,22 @@
 using System.ClientModel.Primitives;
 using System.Collections.Generic;
 using System.IO;
-using System.Text;
+using System.Linq;
 using System.Text.Json;
 
 namespace OpenAI.Examples;
 
 public partial class ChatExamples
 {
     #region
-    public static List<ChatMessage> DeserializeMessages(BinaryData data)
+    public static IEnumerable<ChatMessage> DeserializeMessages(BinaryData data)
     {
-        List<ChatMessage> messages = [];
-        using JsonDocument messagesAsJson = JsonDocument.Parse(data.ToString());
+        using JsonDocument messagesAsJson = JsonDocument.Parse(data.ToMemory());
 
         foreach (JsonElement jsonElement in messagesAsJson.RootElement.EnumerateArray())
         {
-            BinaryData jsonElementAsData = BinaryData.FromString(jsonElement.ToString());
-            ChatMessage message = ModelReaderWriter.Read<ChatMessage>(jsonElementAsData, ModelReaderWriterOptions.Json);
-            messages.Add(message);
+            yield return ModelReaderWriter.Read<ChatMessage>(BinaryData.FromObjectAsJson(jsonElement), ModelReaderWriterOptions.Json);
         }
-
-        return messages;
     }
     #endregion
 
@@ -35,10 +30,12 @@ public static BinaryData SerializeMessages(IEnumerable<ChatMessage> messages)
         using Utf8JsonWriter writer = new(stream);
 
         writer.WriteStartArray();
-        foreach (ChatMessage message in messages)
+
+        foreach (IJsonModel<ChatMessage> message in messages)
         {
-            (message as IJsonModel<ChatMessage>).Write(writer, ModelReaderWriterOptions.Json);
+            message.Write(writer, ModelReaderWriterOptions.Json);
         }
+
         writer.WriteEndArray();
         writer.Flush();
 
@@ -47,7 +44,7 @@ public static BinaryData SerializeMessages(IEnumerable<ChatMessage> messages)
     #endregion
 
     [Test]
-    public void Example06_ChatSerialization()
+    public void Example08_ChatSerialization()
     {
         ChatClient client = new("gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
@@ -68,9 +65,10 @@ public void Example06_ChatSerialization()
             ]
             """u8.ToArray());
 
-        List<ChatMessage> messages = DeserializeMessages(serializedData);
+        List<ChatMessage> messages = DeserializeMessages(serializedData).ToList();
 
         ChatCompletion completion = client.CompleteChat(messages);
+
         messages.Add(new AssistantChatMessage(completion));
 
         foreach (ChatMessage message in messages)

examples/Chat/Example06_ChatSerializationAsync.cs → examples/Chat/Example08_ChatSerializationAsync.cs

@@ -2,14 +2,15 @@
 using OpenAI.Chat;
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using System.Threading.Tasks;
 
 namespace OpenAI.Examples;
 
 public partial class ChatExamples
 {
     [Test]
-    public async Task Example06_ChatSerializationAsync()
+    public async Task Example08_ChatSerializationAsync()
     {
         ChatClient client = new("gpt-4o", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
@@ -30,9 +31,10 @@ public async Task Example06_ChatSerializationAsync()
             ]
             """u8.ToArray());
 
-        List<ChatMessage> messages = DeserializeMessages(serializedData);
+        List<ChatMessage> messages = DeserializeMessages(serializedData).ToList();
 
         ChatCompletion completion = await client.CompleteChatAsync(messages);
+
         messages.Add(new AssistantChatMessage(completion));
 
         foreach (ChatMessage message in messages)

examples/Embeddings/Example04_SimpleEmbeddingProtocol.cs → examples/Embeddings/Example04_EmbeddingProtocol.cs

@@ -9,7 +9,7 @@ namespace OpenAI.Examples;
 public partial class EmbeddingExamples
 {
     [Test]
-    public void Example04_SimpleEmbeddingProtocol()
+    public void Example04_EmbeddingProtocol()
     {
         EmbeddingClient client = new("text-embedding-3-small", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 

examples/Embeddings/Example04_SimpleEmbeddingProtocolAsync.cs → examples/Embeddings/Example04_EmbeddingProtocolAsync.cs

@@ -10,7 +10,7 @@ namespace OpenAI.Examples;
 public partial class EmbeddingExamples
 {
     [Test]
-    public async Task Example04_SimpleEmbeddingProtocolAsync()
+    public async Task Example04_EmbeddingProtocolAsync()
     {
         EmbeddingClient client = new("text-embedding-3-small", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));