feat: support wanx image synthesis api

Author: ikesnowy

src/Cnblogs.DashScope.Sdk/BatchGetEmbeddingsOutput.cs

@@ -1,6 +1,4 @@
-using Cnblogs.DashScope.Sdk.Internals;
-
-namespace Cnblogs.DashScope.Sdk;
+namespace Cnblogs.DashScope.Sdk;
 
 /// <summary>
 /// The output of batch get embeddings api.

src/Cnblogs.DashScope.Sdk/DashScopeClientCore.cs

@@ -92,6 +92,15 @@ Task<ModelResponse<BatchGetEmbeddingsOutput, TextEmbeddingTokenUsage>> BatchGetE
             cancellationToken))!;
     }
 
+    /// <inheritdoc />
+    public async Task<ModelResponse<ImageSynthesisOutput, ImageSynthesisUsage>> CreateImageSynthesisTaskAsync(
+        ModelRequest<ImageSynthesisInput, ImageSynthesisParameters> input,
+        CancellationToken cancellationToken = default)
+    {
+        var request = BuildRequest(HttpMethod.Post, ApiLinks.ImageSynthesis, input, isTask: true);
+        return (await SendAsync<ModelResponse<ImageSynthesisOutput, ImageSynthesisUsage>>(request, cancellationToken))!;
+    }
+
     /// <inheritdoc />
     public async Task<DashScopeTask<TOutput, TUsage>> GetTaskAsync<TOutput, TUsage>(
         string taskId,

src/Cnblogs.DashScope.Sdk/Internals/DashScopeTaskOutput.cs renamed to src/Cnblogs.DashScope.Sdk/DashScopeTaskOutput.cs

@@ -1,6 +1,7 @@
 using System.Text.Json.Serialization;
+using Cnblogs.DashScope.Sdk.Internals;
 
-namespace Cnblogs.DashScope.Sdk.Internals;
+namespace Cnblogs.DashScope.Sdk;
 
 /// <summary>
 /// The common properties of DashScope task.
@@ -35,6 +36,11 @@ public abstract record DashScopeTaskOutput
     [JsonConverter(typeof(DashScopeDateTimeConvertor))]
     public DateTime? EndTime { get; set; }
 
+    /// <summary>
+    /// The metrics of subtasks.
+    /// </summary>
+    public DashScopeTaskMetrics? TaskMetrics { get; set; }
+
     /// <summary>
     /// Error code, not null when <see cref="TaskStatus"/> is Failed.
     /// </summary>

src/Cnblogs.DashScope.Sdk/IDashScopeClient.cs

@@ -65,6 +65,16 @@ Task<ModelResponse<TextEmbeddingOutput, TextEmbeddingTokenUsage>> GetEmbeddingsA
             ModelRequest<BatchGetEmbeddingsInput, BatchGetEmbeddingsParameters> input,
             CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// Create a image synthesis task.
+    /// </summary>
+    /// <param name="input">The input of image synthesis task.</param>
+    /// <param name="cancellationToken">The cancellation token to use.</param>
+    /// <returns></returns>
+    Task<ModelResponse<ImageSynthesisOutput, ImageSynthesisUsage>> CreateImageSynthesisTaskAsync(
+        ModelRequest<ImageSynthesisInput, ImageSynthesisParameters> input,
+        CancellationToken cancellationToken = default);
+
     /// <summary>
     /// Get the task status of given id.
     /// </summary>

src/Cnblogs.DashScope.Sdk/ImageStyles.cs

@@ -0,0 +1,47 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// Available styles for image synthesis task.
+/// </summary>
+public static class ImageStyles
+{
+    /// <summary>
+    /// Use the image style determined by model.
+    /// </summary>
+    public const string Auto = "<auto>";
+
+    /// <summary>
+    /// Generate 3d image in cartoon style.
+    /// </summary>
+    public const string Cartoon3D = "<3d cartoon>";
+
+    /// <summary>
+    /// Generate image in anime style.
+    /// </summary>
+    public const string Anime = "<anime>";
+
+    /// <summary>
+    /// Generate oil painting like image.
+    /// </summary>
+    public const string OilPainting = "<oil painting>";
+
+    /// <summary>
+    /// Generate water color style image.
+    /// </summary>
+    public const string WaterColor = "<watercolor>";
+
+    /// <summary>
+    /// Generate sketch-like image.
+    /// </summary>
+    public const string Sketch = "<sketch>";
+
+    /// <summary>
+    /// Generate image in chinese painting style.
+    /// </summary>
+    public const string ChinesePainting = "<chinese painting>";
+
+    /// <summary>
+    /// Generate image in flat illustration style.
+    /// </summary>
+    public const string FlatIllustration = "<flat illustration>";
+}

src/Cnblogs.DashScope.Sdk/ImageSynthesisInput.cs

@@ -0,0 +1,17 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The inputs of image synthesis task
+/// </summary>
+public class ImageSynthesisInput
+{
+    /// <summary>
+    /// The prompt to generate image from. This will be chopped at max length of 500 characters.
+    /// </summary>
+    public required string Prompt { get; set; }
+
+    /// <summary>
+    /// The negative prompt to generate image from. This will be chopped at max length of 500 characters.
+    /// </summary>
+    public string? NegativePrompt { get; set; }
+}

src/Cnblogs.DashScope.Sdk/ImageSynthesisOutput.cs

@@ -0,0 +1,12 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The output of one image synthesis task.
+/// </summary>
+public record ImageSynthesisOutput : DashScopeTaskOutput
+{
+    /// <summary>
+    /// The generated image results.
+    /// </summary>
+    public List<ImageSynthesisResult>? Results { get; set; }
+}

src/Cnblogs.DashScope.Sdk/ImageSynthesisParameters.cs

@@ -0,0 +1,27 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// Optional parameters for image synthesis task.
+/// </summary>
+public class ImageSynthesisParameters
+{
+    /// <summary>
+    /// Generated image style, defaults to '&lt;auto&gt;'. Use <see cref="ImageStyles"/> to get all available options.
+    /// </summary>
+    public string? Style { get; set; }
+
+    /// <summary>
+    /// Generated image size, defaults to 1024*1024. Another options are: 1280*720 and 720*1280.
+    /// </summary>
+    public string? Size { get; set; }
+
+    /// <summary>
+    /// Number of images requested. Max number is 4, defaults to 1.
+    /// </summary>
+    public int? N { get; set; }
+
+    /// <summary>
+    /// Seed for randomizer. Once set, generated image will use seed, seed+1, seed+2, seed+3 depends on <see cref="N"/>.
+    /// </summary>
+    public int? Seed { get; set; }
+}

src/Cnblogs.DashScope.Sdk/ImageSynthesisResult.cs

@@ -0,0 +1,9 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The result of one image synthesis subtask.
+/// </summary>
+/// <param name="Url">The url of generated image.</param>
+/// <param name="Code">The error code.</param>
+/// <param name="Message">The error message.</param>
+public record ImageSynthesisResult(string? Url = null, string? Code = null, string? Message = null);

src/Cnblogs.DashScope.Sdk/ImageSynthesisUsage.cs

@@ -0,0 +1,7 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The usage of one image synthesis request.
+/// </summary>
+/// <param name="ImageCount">Generated image count.</param>
+public record ImageSynthesisUsage(int ImageCount);