OpenVINO C# API 3.3.1 已完成对 OpenVINO 2026.3 的适配。对于使用 C# 开发 AI 应用的团队这次更新最直接的价值有两个现有 OpenVINO 推理代码可以平滑升级 LLM、Whisper 和视觉语言模型等 GenAI 场景也有了更加完整的 C# 调用方式。目前 API 与对应平台的 2026.3 runtime 均已发布到 NuGet。开发者不需要单独安装 OpenVINO SDK也不需要手动复制 native 动态库只需为项目选择正确的平台包。这次更新带来了什么Core 推理保持兼容OpenVINO 2026.3 的 Core C API 没有引入 ABI 破坏性变化因此已经使用Core、CompiledModel、InferRequest和Tensor的项目升级后通常不需要修改 模型加载和推理代码。常见的图像分类、目标检测、OCR、语义分割和 NLP 推理流程都可以继续使用using OpenVinoSharp; using Core core new(); using CompiledModel compiledModel core.CompileModel(model.xml, CPU); using InferRequest request compiledModel.CreateInferRequest(); request.SetInputTensor(inputTensor); request.Infer(); using Tensor outputTensor request.GetOutputTensor();3.3.1 同时保留了原有 C 风格方法名和 PascalCase 方法名。已有代码可以继续运行 新项目则可以优先使用CompileModel()、CreateInferRequest()、SetInputTensor()和Infer()等更符合 C# 习惯的写法。GenAI 仍然是可选能力只使用传统推理 API 的应用不会主动加载openvino_genai_c。只有需要以下能力时 才需要引入JYPPX.OpenVINO.GenAI.runtime.*LLM 文本生成包括 greedy、beam search、top-k、top-p 和流式输出Whisper 语音识别VLM 图片理解与多轮视觉问答Tokenizer、GenerationConfig、性能指标和聊天历史管理。这使普通推理应用不必承担 GenAI runtime 的包体积和部署依赖而 GenAI 项目仍然可以 通过同一个OpenVinoSharp.GenAI命名空间使用托管 API。VLM 多轮对话使用 ChatHistoryOpenVINO GenAI 2026.3 正式提供 VLM history 调用入口。OpenVINO C# API 通过ChatHistory和GenerateWithHistory()暴露这项能力多轮对话的上下文由应用显式管理。using OpenVinoSharp; using OpenVinoSharp.GenAI; using VLMPipeline pipeline new(modelDirectory, CPU); using ChatHistory history new(); history.AddUserMessage(这张图片里有什么); using VLMDecodedResults first pipeline.GenerateWithHistory(history, new[] { imageTensor }); history.AddAssistantMessage(first.GetText()); history.AddUserMessage(其中最显眼的物体是什么颜色); using VLMDecodedResults second pipeline.GenerateWithHistory(history); history.AddAssistantMessage(second.GetText());图片通常只需要在第一轮传入后续问题通过ChatHistory延续上下文。流式输出也可以在GenerateWithHistory()中传入回调处理。旧版StartChat()和FinishChat()暂时保留以兼容已有代码但已经标记为[Obsolete]。新项目应直接使用 history API已有项目也建议在本次升级时完成迁移 避免继续依赖 OpenVINO GenAI 已弃用的有状态聊天模式。NuGet 安装与版本选择建议把 C# API 和 native runtime 明确锁定到本次发布版本避免构建机或部署环境自动 还原到不一致的 native 版本。Windows Core 推理项目PackageReference IncludeJYPPX.OpenVINO.CSharp.API Version3.3.1 / PackageReference IncludeOpenVINO.runtime.win Version2026.3.0 /Windows GenAI 项目PackageReference IncludeJYPPX.OpenVINO.CSharp.API Version3.3.1 / PackageReference IncludeJYPPX.OpenVINO.GenAI.runtime.win Version2026.3.0 /其他系统只需替换 runtime 包名。2026.3 当前提供的平台如下系统与架构Core runtimeGenAI runtimeWindows x64OpenVINO.runtime.winJYPPX.OpenVINO.GenAI.runtime.winUbuntu 24 x64OpenVINO.runtime.ubuntu.24-x86_64JYPPX.OpenVINO.GenAI.runtime.ubuntu.24-x86_64Ubuntu 22 x64OpenVINO.runtime.ubuntu.22-x86_64JYPPX.OpenVINO.GenAI.runtime.ubuntu.22-x86_64Ubuntu 22 ARM64OpenVINO.runtime.ubuntu.22-arm64JYPPX.OpenVINO.GenAI.runtime.ubuntu.22-arm64RHEL 8 x64OpenVINO.runtime.rhel8-x86_64JYPPX.OpenVINO.GenAI.runtime.rhel8-x86_64CentOS 8 x64OpenVINO.runtime.centos8-x86_64暂无 2026.3 GenAI 包macOS Apple SiliconOpenVINO.runtime.macos-arm64JYPPX.OpenVINO.GenAI.runtime.macos-arm64一个应用通常只应引用目标部署平台对应的 runtime 包。不要同时加入多个 Linux 发行版 或多个 CPU 架构的 native 包否则会增大产物体积也可能让发布目录中的 native 文件 发生冲突。需要注意OpenVINO GenAI 官方版本号为2026.3.0.0对应的 NuGet runtime 包版本统一为2026.3.0。在.csproj中应填写 NuGet 版本而不是四段式的官方归档版本号。升级前需要考虑的几件事1. 区分 Core 与 GenAI 模型Core 推理可以继续使用 OpenVINO IR、ONNX 等受支持模型LLMPipeline、WhisperPipeline和VLMPipeline则需要与 OpenVINO GenAI 兼容的模型目录。仅有一个 普通 ONNX 文件并不等于可以直接传给 GenAI Pipeline。2. 保持托管包和 runtime 版本匹配本次推荐组合是组件推荐版本JYPPX.OpenVINO.CSharp.API3.3.1OpenVINO.runtime.*2026.3.0JYPPX.OpenVINO.GenAI.runtime.*2026.3.0如果应用通过环境变量或系统路径加载自行安装的 OpenVINO需要检查实际被加载的动态库 避免旧版系统 runtime 优先于 NuGet 包进入进程。3. 根据设备准备驱动和插件代码中的CPU、GPU、AUTO等设备名称仍遵循 OpenVINO 的设备规则。runtime 包提供 OpenVINO native 库但 GPU 是否可用仍取决于操作系统、硬件和驱动环境。升级后建议先 枚举可用设备再在目标机器上进行一次真实模型推理。4. 检查发布架构Windows runtime 当前面向 x64macOS 2026.3 包面向 Apple SiliconLinux 则需要同时匹配 发行版和 CPU 架构。项目的RuntimeIdentifier、容器基础镜像和最终部署机器必须一致。5. GenAI 项目优先迁移聊天历史 API如果代码中仍调用StartChat()或FinishChat()升级后会看到弃用警告。这不是立即的 运行时破坏但表示该调用方式不再是后续版本的推荐路径。将用户消息和模型回复显式写入ChatHistory会让上下文管理、会话持久化和问题排查都更加清晰。.NET 版本支持OpenVINO C# API 3.3.1 继续覆盖 .NET Framework 4.6 至 4.8、.NET Core 3.1以及 .NET 5 至 .NET 10。旧项目可以保持当前目标框架新项目建议优先选择仍处于支持周期内的 .NET LTS 版本。无论使用哪个目标框架native runtime 的操作系统和架构要求都不会改变。框架兼容并不 代表任意平台包都能在当前机器上加载。总结OpenVINO C# API 3.3.1 是一次以兼容升级为主的发布传统 Core 推理代码无需大规模改造 只要更新 API 和对应 runtime 即可使用 OpenVINO 2026.3GenAI 用户则可以通过统一的 C# API 完成文本生成、语音识别、视觉理解和基于ChatHistory的多轮对话。对于准备升级的项目可以按下面的顺序执行先确认部署平台与架构再更新 NuGet 版本 运行现有 Core 推理测试最后迁移 GenAI 的聊天历史调用。这样可以把 native 版本变化、 业务代码变化和模型问题分开验证。相关资源OpenVINO C# API NuGet 包项目源码与示例