feat: add logprobs properties

Author: ikesnowy

src/Cnblogs.DashScope.Core/ITextGenerationParameters.cs

@@ -4,7 +4,8 @@ namespace Cnblogs.DashScope.Core;
 /// The text generation options.
 /// </summary>
 public interface ITextGenerationParameters
-    : IIncrementalOutputParameter, ISeedParameter, IProbabilityParameter, IPenaltyParameter, IMaxTokenParameter, IStopTokenParameter
+    : IIncrementalOutputParameter, ISeedParameter, IProbabilityParameter, IPenaltyParameter, IMaxTokenParameter,
+        IStopTokenParameter
 {
     /// <summary>
     /// The format of the result, must be <c>text</c> or <c>message</c>.
@@ -74,4 +75,9 @@ public interface ITextGenerationParameters
     /// Whether to enable parallel tool calling
     /// </summary>
     public bool? ParallelToolCalls { get; }
+
+    /// <summary>
+    /// Options when using QWen-MT models.
+    /// </summary>
+    public TextGenerationTranslationOptions? TranslationOptions { get; set; }
 }

src/Cnblogs.DashScope.Core/TextGenerationChoice.cs

@@ -14,4 +14,9 @@ public class TextGenerationChoice
     /// The generated message.
     /// </summary>
     public TextChatMessage Message { get; set; } = new(Array.Empty<DashScopeFileId>());
+
+    /// <summary>
+    /// Token array with log possibility info.
+    /// </summary>
+    public TextGenerationLogProbs? Logprobs { get; set; }
 }

src/Cnblogs.DashScope.Core/TextGenerationLogProbContent.cs

@@ -0,0 +1,14 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Represents a possible choice of token.
+/// </summary>
+/// <param name="Token">Token content.</param>
+/// <param name="Bytes">Token content in UTF-8 byte array.</param>
+/// <param name="Logprob">Possibility, <c>null</c> when it's too low.</param>
+/// <param name="TopLogprobs">The most possible alternatives.</param>
+public record TextGenerationLogProbContent(
+    string Token,
+    byte[] Bytes,
+    float? Logprob,
+    List<TextGenerationTopLogProbContent> TopLogprobs);

src/Cnblogs.DashScope.Core/TextGenerationLogProbs.cs

@@ -0,0 +1,7 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Possibilities of token choices.
+/// </summary>
+/// <param name="Content">The choices with their possibility.</param>
+public record TextGenerationLogProbs(List<TextGenerationLogProbContent> Content);

src/Cnblogs.DashScope.Core/TextGenerationParameters.cs

@@ -59,6 +59,9 @@ public class TextGenerationParameters : ITextGenerationParameters
     /// <inheritdoc />
     public bool? ParallelToolCalls { get; set; }
 
+    /// <inheritdoc />
+    public TextGenerationTranslationOptions? TranslationOptions { get; set; }
+
     /// <inheritdoc />
     public bool? IncrementalOutput { get; set; }
 }

src/Cnblogs.DashScope.Core/TextGenerationTopLogProbContent.cs

@@ -0,0 +1,9 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Represents one choice of most possibility alternative tokens.
+/// </summary>
+/// <param name="Token">The token content.</param>
+/// <param name="Bytes">The token content in UTF-8 byte array.</param>
+/// <param name="Logprob">Possibility, <c>null</c> when possibility is too low.</param>
+public record TextGenerationTopLogProbContent(string Token, byte[] Bytes, float? Logprob);

src/Cnblogs.DashScope.Core/TextGenerationTranslationOptions.cs

@@ -0,0 +1,32 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Configurations when using translation models.
+/// </summary>
+public class TextGenerationTranslationOptions
+{
+    /// <summary>
+    /// The language name of the input text. Use 'auto' to enable auto-detection.
+    /// </summary>
+    public string SourceLang { get; set; } = "auto";
+
+    /// <summary>
+    /// The language name of the output text.
+    /// </summary>
+    public string TargetLang { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Term list for translation.
+    /// </summary>
+    public IEnumerable<TranslationReference>? Terms { get; set; }
+
+    /// <summary>
+    /// Sample texts for translation
+    /// </summary>
+    public IEnumerable<TranslationReference>? TmList { get; set; }
+
+    /// <summary>
+    /// Domain info about the source text. Only supports English.
+    /// </summary>
+    public string? Domains { get; set; }
+}

src/Cnblogs.DashScope.Core/TranslationReference.cs

@@ -0,0 +1,8 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// A text pair that used for translation reference.
+/// </summary>
+/// <param name="Source">The text in source language.</param>
+/// <param name="Target">The text in target language.</param>
+public record TranslationReference(string Source, string Target);