34 lines
1.5 KiB
C#
34 lines
1.5 KiB
C#
namespace Volcanic.AgenticCore.Telegram.Speech;
|
|
|
|
/// <summary>The <c>Telegram:Speech</c> section. Speech to text is on exactly when <see cref="ApiKey"/> is set.</summary>
|
|
public sealed class SpeechOptions
|
|
{
|
|
public const string DefaultModel = "gpt-4o-transcribe";
|
|
public const string DefaultBaseUrl = "https://api.openai.com/v1";
|
|
|
|
/// <summary>Falls back to <c>OPENAI_API_KEY</c>. Empty turns speech to text off.</summary>
|
|
public string ApiKey { get; set; } = "";
|
|
|
|
/// <summary>Falls back to <c>STT_MODEL</c>, then <see cref="DefaultModel"/>.</summary>
|
|
public string Model { get; set; } = "";
|
|
|
|
/// <summary>Any OpenAI-compatible transcription endpoint.</summary>
|
|
public string BaseUrl { get; set; } = DefaultBaseUrl;
|
|
|
|
/// <summary>Optional ISO-639-1 hint.</summary>
|
|
public string? Language { get; set; }
|
|
|
|
/// <summary>Tries per transcription; network errors, timeouts, 408, 429 and 5xx are retried.</summary>
|
|
public const int MaxAttempts = 3;
|
|
|
|
/// <summary>The wait before the second attempt, doubled before the third. Internal so tests can zero it.</summary>
|
|
internal TimeSpan RetryDelay { get; set; } = TimeSpan.FromSeconds(1);
|
|
|
|
public bool IsEnabled => !string.IsNullOrWhiteSpace(ApiKey);
|
|
|
|
public string ResolvedModel => string.IsNullOrWhiteSpace(Model) ? DefaultModel : Model.Trim();
|
|
|
|
/// <summary>The startup log line (never the key).</summary>
|
|
public string Describe() => IsEnabled ? $"Speech to text: {ResolvedModel}" : "Speech to text: off (no OPENAI_API_KEY)";
|
|
}
|