feat: add wanx background image generation api support

Author: ikesnowy

src/Cnblogs.DashScope.Sdk/BackgroundGenerationInput.cs

@@ -0,0 +1,37 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The input of background generation task.
+/// </summary>
+public class BackgroundGenerationInput
+{
+    /// <summary>
+    /// The image url to generation background on.
+    /// </summary>
+    public required string BaseImageUrl { get; set; }
+
+    /// <summary>
+    /// The reference image url for.
+    /// </summary>
+    public string? RefImageUrl { get; set; }
+
+    /// <summary>
+    /// The prompt the background would generation from.
+    /// </summary>
+    public string? RefPrompt { get; set; }
+
+    /// <summary>
+    /// The negative prompt.
+    /// </summary>
+    public string? NegRefPrompt { get; set; }
+
+    /// <summary>
+    /// The title to be put in generated image, max length is 8.
+    /// </summary>
+    public string? Title { get; set; }
+
+    /// <summary>
+    /// Valid when <see cref="Title"/> is set, max length is 10.
+    /// </summary>
+    public string? SubTitle { get; set; }
+}

src/Cnblogs.DashScope.Sdk/BackgroundGenerationOutput.cs

@@ -0,0 +1,17 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The output of background generation task.
+/// </summary>
+public record BackgroundGenerationOutput : DashScopeTaskOutput
+{
+    /// <summary>
+    /// The generated image urls.
+    /// </summary>
+    public List<BackgroundGenerationResult>? Results { get; set; }
+
+    /// <summary>
+    /// The generated result of texts.
+    /// </summary>
+    public BackgroundGenerationTextResult? TextResults { get; set; }
+}

src/Cnblogs.DashScope.Sdk/BackgroundGenerationParameters.cs

@@ -0,0 +1,22 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The parameters of background generation task.
+/// </summary>
+public class BackgroundGenerationParameters
+{
+    /// <summary>
+    /// The number of images to be generated.
+    /// </summary>
+    public int? N { get; set; }
+
+    /// <summary>
+    /// Range at [0, 999], controls the distance from generated image to reference image.
+    /// </summary>
+    public int? NoiseLevel { get; set; }
+
+    /// <summary>
+    /// Range at [0,1]. When RefImageUrl and RefPrompt are both set, controls the percentage of ref prompt weight.
+    /// </summary>
+    public float? RefPromptWeight { get; set; }
+}

src/Cnblogs.DashScope.Sdk/BackgroundGenerationResult.cs

@@ -0,0 +1,7 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The result of background generation task.
+/// </summary>
+/// <param name="Url">The url of generated image.</param>
+public record BackgroundGenerationResult(string Url);

src/Cnblogs.DashScope.Sdk/BackgroundGenerationTextResult.cs

@@ -0,0 +1,10 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The results of background generation task.
+/// </summary>
+/// <param name="Urls">The urls of images that put texts on.</param>
+/// <param name="Params">The generated texts for image.</param>
+public record BackgroundGenerationTextResult(
+    List<BackgroundGenerationTextResultUrl> Urls,
+    List<BackgroundGenerationTextResultParams>? Params);

src/Cnblogs.DashScope.Sdk/BackgroundGenerationTextResultGradient.cs

@@ -0,0 +1,18 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The gradient of background generation text.
+/// </summary>
+/// <param name="Type">Type of gradient. e.g. <c>linear</c></param>
+/// <param name="GradientUnits">Unit of gradient. e.g. <c>pixels</c></param>
+/// <param name="ColorStops">Color stops of gradient.</param>
+public record BackgroundGenerationTextResultGradient(
+    string Type,
+    string GradientUnits,
+    List<BackgroundGenerationTextResultGradientColorStop> ColorStops)
+{
+    /// <summary>
+    /// Coords of each stop, use "x1", "y1", "x2", "y2"... to access the coords.
+    /// </summary>
+    public Dictionary<string, int>? Coords { get; set; }
+}

src/Cnblogs.DashScope.Sdk/BackgroundGenerationTextResultGradientColorStop.cs

@@ -0,0 +1,8 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The color stop of gradient in background generation result.
+/// </summary>
+/// <param name="Color">The color of current stop.</param>
+/// <param name="Offset">The position of current stop.</param>
+public record BackgroundGenerationTextResultGradientColorStop(string Color, float Offset);

src/Cnblogs.DashScope.Sdk/BackgroundGenerationTextResultLayer.cs

@@ -0,0 +1,60 @@
+using System.Text.Json.Serialization;
+using Cnblogs.DashScope.Sdk.Internals;
+
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// Represents one layer of background generation text result.
+/// </summary>
+/// <param name="Idx">The if of the layer.</param>
+/// <param name="Type">The type of layer, can be "text" or "text_mask".</param>
+/// <param name="Top">The top position of the layer.</param>
+/// <param name="Left">The left position of the layer.</param>
+/// <param name="Width">The width of the layer.</param>
+/// <param name="Height">The height of the layer.</param>
+/// <param name="SubType">Available when type is "text". The type of text, can ba "Title" or "SubTitle".</param>
+/// <param name="Content">Available when type is "text". The content of the text.</param>
+/// <param name="FontFamily">Available when type is "text". The font family of the text.</param>
+/// <param name="FontSize">Available when type is "text". The font size of the text.</param>
+/// <param name="FontWeight">Available when type is "text". The font weight of the text. e.g. Medium.</param>
+/// <param name="FontColor">Available when type is "text". The color of the text in HEX format.</param>
+/// <param name="Direction">Available when type is "text". The direction of the text. e.g. vertical or horizontal.</param>
+/// <param name="Alignment">Available when type is "text". The alignment of the text, can be center, left or right.</param>
+/// <param name="LineHeight">Available when type is "text". The line height of the text.</param>
+/// <param name="FontItalic">Available when type is "text". Is the text needs to be italic.</param>
+/// <param name="FontLineThrough">Available when type is "text". Is the text has line through.</param>
+/// <param name="FontUnderLine">Available when type is "text". Is the text has underline.</param>
+/// <param name="TextShadow">Available when type is "text". The text shadow of the text. e.g. 2px 2px #80808080</param>
+/// <param name="TextStroke">Available when type is "text". The stroke of the text. e.g. 1px #fffffff0</param>
+/// <param name="Opacity">The opacity of the layer.</param>
+/// <param name="Radius">Available when type is "text_mask". The border radius of the mask.</param>
+/// <param name="BoxShadow">Available when type is "text_mask". The box shadow of the mask.</param>
+/// <param name="Color">Available when type is "text_mask". Color of the mask.</param>
+/// <param name="Gradient">Available when type is "text_mask". The gradient of the mask.</param>
+public record BackgroundGenerationTextResultLayer(
+    int Idx,
+    string Type,
+    int Top,
+    int Left,
+    int Width,
+    int Height,
+    string? SubType = null,
+    string? Content = null,
+    string? FontFamily = null,
+    int? FontSize = null,
+    string? FontWeight = null,
+    string? FontColor = null,
+    string? Direction = null,
+    string? Alignment = null,
+    float? LineHeight = null,
+    bool? FontItalic = null,
+    bool? FontLineThrough = null,
+    bool? FontUnderLine = null,
+    [property: JsonConverter(typeof(DashScopeZeroAsNullConvertor))]
+    string? TextShadow = null,
+    string? TextStroke = null,
+    float? Opacity = null,
+    int? Radius = null,
+    string? BoxShadow = null,
+    string? Color = null,
+    BackgroundGenerationTextResultGradient? Gradient = null);

src/Cnblogs.DashScope.Sdk/BackgroundGenerationTextResultParams.cs

@@ -0,0 +1,8 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The generated styles of text in one image of background generation task.
+/// </summary>
+/// <param name="SampleIdx">The id of image.</param>
+/// <param name="Layers">The layers of styled text.</param>
+public record BackgroundGenerationTextResultParams(int SampleIdx, List<BackgroundGenerationTextResultLayer> Layers);

src/Cnblogs.DashScope.Sdk/BackgroundGenerationTextResultUrl.cs

@@ -0,0 +1,7 @@
+namespace Cnblogs.DashScope.Sdk;
+
+/// <summary>
+/// The generated background text url.
+/// </summary>
+/// <param name="Url">The url of generated text.</param>
+public record BackgroundGenerationTextResultUrl(string Url);