Add protocol method support for Video APIs

api/OpenAI.net8.0.cs

@@ -37,6 +37,8 @@ public class OpenAIClient {
         public virtual RealtimeClient GetRealtimeClient();
         [Experimental("OPENAI001")]
         public virtual VectorStoreClient GetVectorStoreClient();
+        [Experimental("OPENAI001")]
+        public virtual VideoClient GetVideoClient();
     }
     public class OpenAIClientOptions : ClientPipelineOptions {
         public Uri Endpoint { get; set; }
@@ -6815,4 +6817,31 @@ public enum VectorStoreStatus {
         Completed = 2,
         Expired = 3
     }
+}
+namespace OpenAI.Videos {
+    [Experimental("OPENAI001")]
+    public class VideoClient {
+        protected VideoClient();
+        public VideoClient(ApiKeyCredential credential, OpenAIClientOptions options);
+        public VideoClient(ApiKeyCredential credential);
+        public VideoClient(AuthenticationPolicy authenticationPolicy, OpenAIClientOptions options);
+        public VideoClient(AuthenticationPolicy authenticationPolicy);
+        protected internal VideoClient(ClientPipeline pipeline, OpenAIClientOptions options);
+        public VideoClient(string apiKey);
+        [Experimental("OPENAI001")]
+        public Uri Endpoint { get; }
+        public ClientPipeline Pipeline { get; }
+        public virtual ClientResult CreateVideo(BinaryContent content, string contentType, RequestOptions options = null);
+        public virtual Task<ClientResult> CreateVideoAsync(BinaryContent content, string contentType, RequestOptions options = null);
+        public virtual ClientResult CreateVideoRemix(string videoId, BinaryContent content, string contentType, RequestOptions options = null);
+        public virtual Task<ClientResult> CreateVideoRemixAsync(string videoId, BinaryContent content, string contentType, RequestOptions options = null);
+        public virtual ClientResult DeleteVideo(string videoId, RequestOptions options = null);
+        public virtual Task<ClientResult> DeleteVideoAsync(string videoId, RequestOptions options = null);
+        public virtual ClientResult DownloadVideo(string videoId, string variant = null, RequestOptions options = null);
+        public virtual Task<ClientResult> DownloadVideoAsync(string videoId, string variant = null, RequestOptions options = null);
+        public virtual ClientResult GetVideo(string videoId, RequestOptions options = null);
+        public virtual Task<ClientResult> GetVideoAsync(string videoId, RequestOptions options = null);
+        public virtual ClientResult GetVideos(long? limit = null, string order = null, string after = null, RequestOptions options = null);
+        public virtual Task<ClientResult> GetVideosAsync(long? limit = null, string order = null, string after = null, RequestOptions options = null);
+    }
 }

api/OpenAI.netstandard2.0.cs

@@ -25,6 +25,7 @@ public class OpenAIClient {
         public virtual OpenAIResponseClient GetOpenAIResponseClient(string model);
         public virtual RealtimeClient GetRealtimeClient();
         public virtual VectorStoreClient GetVectorStoreClient();
+        public virtual VideoClient GetVideoClient();
     }
     public class OpenAIClientOptions : ClientPipelineOptions {
         public Uri Endpoint { get; set; }
@@ -6007,4 +6008,29 @@ public enum VectorStoreStatus {
         Completed = 2,
         Expired = 3
     }
+}
+namespace OpenAI.Videos {
+    public class VideoClient {
+        protected VideoClient();
+        public VideoClient(ApiKeyCredential credential, OpenAIClientOptions options);
+        public VideoClient(ApiKeyCredential credential);
+        public VideoClient(AuthenticationPolicy authenticationPolicy, OpenAIClientOptions options);
+        public VideoClient(AuthenticationPolicy authenticationPolicy);
+        protected internal VideoClient(ClientPipeline pipeline, OpenAIClientOptions options);
+        public VideoClient(string apiKey);
+        public Uri Endpoint { get; }
+        public ClientPipeline Pipeline { get; }
+        public virtual ClientResult CreateVideo(BinaryContent content, string contentType, RequestOptions options = null);
+        public virtual Task<ClientResult> CreateVideoAsync(BinaryContent content, string contentType, RequestOptions options = null);
+        public virtual ClientResult CreateVideoRemix(string videoId, BinaryContent content, string contentType, RequestOptions options = null);
+        public virtual Task<ClientResult> CreateVideoRemixAsync(string videoId, BinaryContent content, string contentType, RequestOptions options = null);
+        public virtual ClientResult DeleteVideo(string videoId, RequestOptions options = null);
+        public virtual Task<ClientResult> DeleteVideoAsync(string videoId, RequestOptions options = null);
+        public virtual ClientResult DownloadVideo(string videoId, string variant = null, RequestOptions options = null);
+        public virtual Task<ClientResult> DownloadVideoAsync(string videoId, string variant = null, RequestOptions options = null);
+        public virtual ClientResult GetVideo(string videoId, RequestOptions options = null);
+        public virtual Task<ClientResult> GetVideoAsync(string videoId, RequestOptions options = null);
+        public virtual ClientResult GetVideos(long? limit = null, string order = null, string after = null, RequestOptions options = null);
+        public virtual Task<ClientResult> GetVideosAsync(long? limit = null, string order = null, string after = null, RequestOptions options = null);
+    }
 }

examples/OpenAI.Examples.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <TargetFramework>net9.0</TargetFramework>
 

examples/Videos/Example01_VideoCreation.cs

@@ -0,0 +1,48 @@
+using NUnit.Framework;
+using NUnit.Framework.Internal;
+using OpenAI.Videos;
+using System;
+using System.ClientModel;
+using System.Net.Http;
+using System.Text;
+using System.Text.Json;
+
+namespace OpenAI.Examples;
+
+// This example uses experimental APIs which are subject to change. To use experimental APIs,
+// please acknowledge their experimental status by suppressing the corresponding warning.
+#pragma warning disable OPENAI001
+
+public partial class VideoExamples
+{
+    [Test]
+    public void Example01_VideoCreation()
+    {
+        // 1) Create the client
+        VideoClient client = new(new ApiKeyCredential(Environment.GetEnvironmentVariable("OPENAI_API_KEY")));
+
+        // 2) Build the multipart/form-data payload with an explicit boundary
+        var boundary = Guid.NewGuid().ToString();
+        var contentType = $"multipart/form-data; boundary=\"{boundary}\"";
+        using var multipart = new MultipartFormDataContent(boundary);
+
+        multipart.Add(new StringContent("sora-2", Encoding.UTF8, "text/plain"), "model");
+        multipart.Add(new StringContent("A calico cat playing a piano on stage", Encoding.UTF8, "text/plain"), "prompt");
+
+        // 3) Get a stream for the multipart body
+        using var bodyStream = multipart.ReadAsStream();
+
+        // 4) Send the request
+        var createResult = client.CreateVideo(BinaryContent.Create(bodyStream), contentType);
+        var createRaw = createResult.GetRawResponse().Content;
+
+        // 5) Parse the JSON response
+        using var createdDoc = JsonDocument.Parse(createRaw);
+        var id = createdDoc.RootElement.GetProperty("id").GetString();
+        var status = createdDoc.RootElement.GetProperty("status").GetString();
+
+        Console.WriteLine($"CreateVideo => id: {id}, status: {status}");
+    }
+}
+
+#pragma warning restore OPENAI001

examples/Videos/Example01_VideoCreationAsync.cs

@@ -0,0 +1,49 @@
+using NUnit.Framework;
+using NUnit.Framework.Internal;
+using OpenAI.Videos;
+using System;
+using System.ClientModel;
+using System.Net.Http;
+using System.Text;
+using System.Text.Json;
+using System.Threading.Tasks;
+
+namespace OpenAI.Examples;
+
+// This example uses experimental APIs which are subject to change. To use experimental APIs,
+// please acknowledge their experimental status by suppressing the corresponding warning.
+#pragma warning disable OPENAI001
+
+public partial class VideoExamples
+{
+    [Test]
+    public async Task Example01_VideoCreationAsync()
+    {
+        // 1) Create the client
+        VideoClient client = new(new ApiKeyCredential(Environment.GetEnvironmentVariable("OPENAI_API_KEY")));
+
+        // 2) Build the multipart/form-data payload with an explicit boundary
+        var boundary = Guid.NewGuid().ToString();
+        var contentType = $"multipart/form-data; boundary=\"{boundary}\"";
+        using var multipart = new MultipartFormDataContent(boundary);
+
+        multipart.Add(new StringContent("sora-2", Encoding.UTF8, "text/plain"), "model");
+        multipart.Add(new StringContent("A calico cat playing a piano on stage", Encoding.UTF8, "text/plain"), "prompt");
+
+        // 3) Get a stream for the multipart body
+        using var bodyStream = await multipart.ReadAsStreamAsync();
+
+        // 4) Send the request
+        var createResult = await client.CreateVideoAsync(BinaryContent.Create(bodyStream), contentType);
+        var createRaw = createResult.GetRawResponse().Content;
+
+        // 5) Parse the JSON response
+        using var createdDoc = JsonDocument.Parse(createRaw);
+        var id = createdDoc.RootElement.GetProperty("id").GetString();
+        var status = createdDoc.RootElement.GetProperty("status").GetString();
+
+        Console.WriteLine($"CreateVideo => id: {id}, status: {status}");
+    }
+}
+
+#pragma warning restore OPENAI001

scripts/Export-Api.ps1

@@ -272,6 +272,7 @@ function Invoke-GenAPI {
     $content = $content -creplace "Realtime\.", ""
     $content = $content -creplace "Responses\.", ""
     $content = $content -creplace "VectorStores\.", ""
+    $content = $content -creplace "Videos\.", ""
 
     # Remove Diagnostics.DebuggerStepThrough attribute.
     $content = $content -creplace ".*Diagnostics.DebuggerStepThrough.*\n", ""

specification/base/typespec/common/models.tsp

@@ -468,3 +468,12 @@ union ServiceTier {
   "flex",
   "scale",
 }
+
+#suppress "@azure-tools/typespec-azure-core/no-enum" "Auto-suppressed warnings non-applicable rules during import."
+#suppress "@azure-tools/typespec-azure-core/documentation-required" "Auto-suppressed warnings non-applicable rules during import."
+enum OrderEnum {
+  #suppress "@azure-tools/typespec-azure-core/documentation-required" "Auto-suppressed warnings non-applicable rules during import."
+  asc,
+  #suppress "@azure-tools/typespec-azure-core/documentation-required" "Auto-suppressed warnings non-applicable rules during import."
+  desc,
+}

specification/base/typespec/main.tsp

@@ -19,4 +19,5 @@ import "./runs";
 import "./threads";
 import "./responses";
 import "./vector-stores";
+import "./videos";
 import "./uploads";

specification/base/typespec/videos/main.tsp

@@ -0,0 +1,2 @@
+import "./models.tsp";
+import "./operations.tsp";