Implement Azure OpenAI Service

Author: Nils Clauß

OpenAI_API/EndpointBase.cs

@@ -44,16 +44,31 @@ protected string Url
 		{
 			get
 			{
-				return $"{_Api.ApiUrlBase}{Endpoint}";
+				return $"{_Api.ApiUrlBase}{Endpoint}?{ApiVersionParameter}";
 			}
 		}
 
-		/// <summary>
-		/// Gets an HTTPClient with the appropriate authorization and other headers set
-		/// </summary>
-		/// <returns>The fully initialized HttpClient</returns>
-		/// <exception cref="AuthenticationException">Thrown if there is no valid authentication.  Please refer to <see href="https://github.com/OkGoDoIt/OpenAI-API-dotnet#authentication"/> for details.</exception>
-		protected HttpClient GetClient()
+        /// <summary>
+        /// Gets the version of the endpoint as url parameter, based on the configuration in the api definition.  For example "https://learn.microsoft.com/en-us/azure/cognitive-services/openai/reference#rest-api-versioning"
+        /// </summary>
+        protected string ApiVersionParameter
+        {
+            get
+            {
+                if(string.IsNullOrEmpty(_Api.ApiVersion))
+				{
+					return "";
+				}
+				return $"api-version={_Api.ApiVersion}";
+            }
+        }
+
+        /// <summary>
+        /// Gets an HTTPClient with the appropriate authorization and other headers set
+        /// </summary>
+        /// <returns>The fully initialized HttpClient</returns>
+        /// <exception cref="AuthenticationException">Thrown if there is no valid authentication.  Please refer to <see href="https://github.com/OkGoDoIt/OpenAI-API-dotnet#authentication"/> for details.</exception>
+        protected HttpClient GetClient()
 		{
 			if (_Api.Auth?.ApiKey is null)
 			{
@@ -62,7 +77,9 @@ protected HttpClient GetClient()
 
 			HttpClient client = new HttpClient();
 			client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", _Api.Auth.ApiKey);
-			client.DefaultRequestHeaders.Add("User-Agent", Value);
+			// Further authentication-header used for Azure openAI service
+			client.DefaultRequestHeaders.Add("api-key", _Api.Auth.ApiKey);
+            client.DefaultRequestHeaders.Add("User-Agent", Value);
 			if (!string.IsNullOrEmpty(_Api.Auth.OpenAIOrganization)) client.DefaultRequestHeaders.Add("OpenAI-Organization", _Api.Auth.OpenAIOrganization);
 
 			return client;

OpenAI_API/OpenAIAPI.cs

@@ -14,11 +14,16 @@ public class OpenAIAPI
 		/// Base url for OpenAI
 		/// </summary>
 		public string ApiUrlBase = "https://api.openai.com/v1/";
-		
-		/// <summary>
-		/// The API authentication information to use for API calls
-		/// </summary>
-		public APIAuthentication Auth { get; set; }
+
+        /// <summary>
+        /// Version of the Rest Api. Needed for e.g. for the Azure OpenAI service.
+        /// </summary>
+        public string ApiVersion { get; set; }
+
+        /// <summary>
+        /// The API authentication information to use for API calls
+        /// </summary>
+        public APIAuthentication Auth { get; set; }
 
 		/// <summary>
 		/// Creates a new entry point to the OpenAPI API, handling auth and allowing access to the various API endpoints

README.md

@@ -5,6 +5,7 @@ A simple C# .NET wrapper library to use with OpenAI's GPT-3 API.  More context [
 ## Status
 Updated to work with the current API as of February 2, 2023.  Added Files and Embedding endpoints. Removed the Search endpoint as OpenAI has removed that API.
 Potentially breaking change with v1.4:  The various endpoints (Completions, Models, etc) and related classes have each moved into their own namespaces, for example `OpenAI_API.Completions.CompletionRequest` and `OpenAI_API.Models.Model.DavinciText`.  You may need to add `using`s or fully qualify names in exisitng code.
+Now also works with the Azure OpenAI Service. See Azure section for further details.
 
 Thank you [@GotMike](https://github.com/gotmike), [@gmilano](https://github.com/gmilano), [@metjuperry](https://github.com/metjuperry), and [@Alexei000](https://github.com/Alexei000) for your contributions!
 
@@ -143,6 +144,30 @@ There are also methods to get file contents, delete a file, etc.
 
 The fine-tuning endpoint itself has not yet been implemented, but will be added soon.
 
+### Azure
+
+For using the Azure OpenAI Service, you need to define the Api-Version of the OpenAIAPI class. Currently only the following version is suported by azure: `2022-12-01`.
+
+Refer the Azure OpenAI documentation for further informations: [REST API versioning](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/reference#rest-api-versioning)
+
+Additionally you need to specify the BaseUrl to your API. The Url should look something like:
+```http
+https://{your-resource-name}.openai.azure.com/openai/deployments/{deployment-id}
+```
+
+
+Configuration should look something like this for the Azure service:
+
+```csharp
+// authentication methods as specified above in authentication section
+OpenAIAPI api = new OpenAIAPI(); // uses default, env, or config file
+// configure your specific azure settings
+api.ApiUrlBase = "https://{your-resource-name}.openai.azure.com/openai/deployments/{deployment-id}";
+api.ApiVersion = "2022-12-01"
+```
+
+The API-Key for Azure Service should be provided like the api-key for the OpenAI native API. Currently this library only supports the api-key flow, not the AD-Flow.
+
 ## Documentation
 
 Every single class, method, and property has extensive XML documentation, so it should show up automatically in IntelliSense.  That combined with the official OpenAI documentation should be enough to get started.  Feel free to open an issue here if you have any questions.  Better documentation may come later.