openai

在 .NET 项目里一键调用 ChatGPT、DALL-E、Whisper 等 AI 能力

OpenAI 是一个由 Betalgo Ranul 开发的 .NET 库，用于调用 OpenAI 服务 API。它解决了 .NET 开发者无法方便地使用官方 OpenAI SDK（主要面向 Python/Node.js）的问题，提供了一套完整的 C# 封装。核心能力包括：支持 ChatGPT 对话补全、DALL-E 图像生成、Whisper 语音转文字、文本嵌入、微调等主流 AI 功能；兼容 Azure OpenAI 服务，可灵活切换端点；提供异步 API、流式响应、重试机制等高级特性；支持 .NET Standard 2.0 及以上版本，易于集成到现有 .NET 项目中。该库通过 NuGet 分发，社区活跃，持续跟进 OpenAI 最新接口变化，是 .NET 生态中最流行的 OpenAI 客户端之一。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3025

维护状态低维护

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队betalgo

所属国家

官网地址https://ranultinga.com

GitHubhttps://github.com/betalgo/openai

定价模式free

价格说明开源.NET库，MIT许可证，完全免费，需自行部署集成。

访问状态

是否开源是

开源协议MIT

主要语言C#

技术栈/模型azure-openai,chatgpt,csharp,dall-e,dotnet,openai,openai-api,ranul,sdk,tinga,whisper,whisper-ai

GitHub 星标★ 3025

30天Star增速

HF 下载量

上线时间2021-11-28 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：库/依赖 5 步

环境要求

已安装可用的 .NET 开发环境（库支持 .NET Standard 2.0 及以上）
Visual Studio 或可执行 NuGet 包管理命令的开发工具
OpenAI API Key（从 platform.openai.com 获取）
Organization ID（可选，从 platform.openai.com 账户设置获取）

安装与启动步骤

1准备 .NET 环境

该库是 .NET Standard 2.0 及以上的类库，需先确保本机已装好 .NET SDK 和 NuGet 包管理能力，再创建或打开一个 .NET 项目。
2安装核心库

在 Visual Studio 的包管理器控制台执行，安装社区核心库。注意包 ID 已从 Betalgo.OpenAI 改名为 Betalgo.Ranul.OpenAI。
```
Install-Package Betalgo.Ranul.OpenAI
```
3安装工具库

可选步骤。实验性工具库提供额外辅助能力，仅在需要时安装，避免引入不必要的依赖。
```
Install-Package Betalgo.OpenAI.Utilities
```
4获取 API Key

访问 platform.openai.com 的 API Keys 页面创建密钥；Organization ID 在同站点的 org-settings 页面查看，二者后续用于初始化客户端。
5参考 Playground 示例

仓库内含示例项目 OpenAI.Playground，可对照学习各功能调用方式。注意其中部分测试方法会增删文件或微调模型，建议使用独立账号实验。

关键配置

配置项	必填	说明	示例
`API Key`	是	调用 OpenAI 服务的身份凭证，创建客户端时必须提供	`sk-xxxxxxxxxxxxxxxxxxxxxxxx`
`Organization ID`	否	指定调用的组织，可从账户设置页面获取	`org-xxxxxxxxxxxxxxxxxxxxxxxx`

如何确认成功

安装完成后，项目中能正确引用该库的包与命名空间，并可成功编译运行 Playground 示例项目。

常见问题

Q：包名为什么和以前不一样？

A：项目已更换 PackageId 和命名空间，Betalgo.OpenAI 现为 Betalgo.Ranul.OpenAI，旧代码需按官方迁移指南调整引用。

Q：这个库是 OpenAI 官方 SDK 吗？

A：不是，它是由 Betalgo Ranul 维护的社区库，用于让 .NET 开发者方便地调用 OpenAI API。

Q：运行示例项目有什么风险？

A：部分测试方法会新增或删除你的文件、微调模型，官方建议使用独立账号而非主账号进行实验。

Q：支持 Azure OpenAI 吗？

A：支持，该库兼容 Azure OpenAI 服务，可灵活切换调用端点。

注意事项

核心包 ID 和命名空间已变更，务必使用 Betalgo.Ranul.OpenAI，不要照抄旧教程中的 Betalgo.OpenAI。
Playground 示例含破坏性测试方法，请勿在主账号上运行。
API Key 属于敏感信息，不要硬编码提交到代码仓库。
遇到问题可查阅项目 Wiki、Discord 与 GitHub Discussions。

核心亮点

覆盖 OpenAI 全 API（对话、图像、语音、嵌入），功能完整
支持 Azure OpenAI，方便企业级云服务切换
异步和流式响应支持，性能体验好

不足之处

文档示例偏少，上手需参考源码或社区
对最新 API 的适配有时滞后于官方发布

适用场景

在 C# 桌面或服务端应用中集成智能客服
构建 .NET 批处理工具，批量调用 AI 生成内容
企业 Azure 环境下的 AI 功能开发

替代项目

OpenAI .NET SDK（官方）、Betalgo.OpenAI.GPT3、RestEase 自封装 OpenAI API

项目介绍

openai 是基础设施领域的开源项目，由 betalgo 开发，2021 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,025）位列前 30%，在基础设施分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。开源.NET库，MIT许可证，完全免费，需自行部署集成。

它主要面向的使用场景是：在C#桌面或服务端应用中集成智能客服。同类可对比的替代方案包括 OpenAI .NET SDK（官方）、Betalgo.OpenAI.GPT3、RestEase 自封装 OpenAI API。

上一篇：VibeGuard

下一篇：coai