OpenAI.Net

项目介绍：OpenAI.Net

OpenAI.Net 项目是专为 .NET 平台设计的 OpenAI API 库，旨在帮助开发者通过 C# 轻松集成并使用 OpenAI 的功能。这个由社区维护的库不仅能保持与时俱进，还能经过全面测试，支持 .NET Core 6.0 及更高的版本。

通过直观的 API，该库简化了与 OpenAI 强大的自然语言处理工具交互的过程。此外，OpenAI.Net 还有效管理 HTTP 客户端的使用，避免插槽耗尽和 DNS 更新失败等问题，从而为开发者提供流畅而可靠的使用体验。该库还支持 OpenAI 的流式 API，允许开发者实时处理和分析大量数据。

如何开始

要开始使用 OpenAI.Net，可以从 NuGet 包管理器中安装所需的包：

Install-Package OpenAI.Net.Client

之后，需要使用提供的扩展方法注册服务：

services.AddOpenAIServices(options => {
    options.ApiKey = builder.Configuration["OpenAI:ApiKey"];
});

为了安全地存储 API 密钥，我们建议使用环境变量、配置文件或机密文件。

示例用法

可以在 OpenAI.Net 项目的 GitHub 主页查看控制台应用程序、Web 应用程序以及使用流式 API 的 Blazor 应用程序的示例。此外，集成测试部分也提供了更多用法示例。以下是一个简单的控制台应用程序示例：

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using OpenAI.Net;

namespace ConsoleApp
{
    internal class Program
    {
        static async void Main(string[] args)
        {
            using var host = Host.CreateDefaultBuilder(args)
            .ConfigureServices((builder, services) =>
            {
                services.AddOpenAIServices(options => {
                    options.ApiKey = builder.Configuration["OpenAI:ApiKey"];
                });
            })
            .Build();

            var openAi = host.Services.GetService<IOpenAIService>();
            var response = await openAi.TextCompletion.Get("How long until we reach mars?");

            if (response.IsSuccess)
            {
                foreach(var result in response.Result.Choices)
                {
                    Console.WriteLine(result.Text);
                }
            }
            else
            {
                Console.WriteLine($"{response.ErrorMessage}");
            }
        }
    }
}

HTTP 客户端选项配置

可以通过 IHttpClientBuilder 接口配置 HTTP 客户端，例如，可以为其添加 Polly 重试策略：

services.AddOpenAIServices(options => {
    options.ApiKey = builder.Configuration["OpenAI:ApiKey"];
}, 
(httpClientOptions) => {
    httpClientOptions.AddPolicyHandler(GetRetryPolicy());
});

static IAsyncPolicy<HttpResponseMessage> GetRetryPolicy()
{
    return HttpPolicyExtensions
        .HandleTransientHttpError()
        .WaitAndRetryAsync(3, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2,
                                                                    retryAttempt)));
}