namespace Dpz.Core.Service.Network.Models;

/// <summary>
/// 提供 OpenAI 聊天所需的接口地址、凭据和默认请求设置。
/// </summary>
public class OpenAiChatOptions
{
    /// <summary>
    /// 获取或设置兼容 OpenAI API 的必需基础地址。
    /// </summary>
    public string Endpoint { get; set; } = string.Empty;

    /// <summary>
    /// 获取或设置 SDK 认证策略使用的必需 API Key。
    /// </summary>
    public string ApiKey { get; set; } = string.Empty;

    /// <summary>
    /// 获取或设置请求未覆盖时使用的默认模型名称。
    /// </summary>
    public string Model { get; set; } = string.Empty;

    /// <summary>
    /// 获取或设置请求模型输出的默认最大 token 数。
    /// </summary>
    public int? MaxOutputTokenCount { get; set; }

    /// <summary>
    /// 获取或设置默认采样温度。
    /// </summary>
    public float? Temperature { get; set; }

    /// <summary>
    /// 获取或设置默认核采样值。
    /// </summary>
    public float? TopP { get; set; }

    /// <summary>
    /// 获取或设置默认频率惩罚值。
    /// </summary>
    public float? FrequencyPenalty { get; set; }
}