openai-structured-outputs-samples
openai-structured-outputs-samples 是一套由 OpenAI 官方提供的开源示例应用集合,专为开发者设计,用于快速掌握 Structured Outputs 功能。这项技术能让大模型的回复严格遵循预设的 JSON 结构,有效解决了传统模式下模型输出随机性强、难以被程序可靠解析的痛点。
通过这套资源,开发者可以直观地看到如何将不可预测的文本生成转化为确定性的工作流程。仓库内包含了三个典型场景的应用:简历信息提取、动态生成用户界面(Generative UI)以及结合多轮对话与工具调用的智能助手。所有示例均基于 NextJS 构建,代码清晰易懂。
无论是希望快速验证创意原型,还是寻找生产级项目的启动模板,openai-structured-outputs-samples 都能提供实用的参考。项目采用 MIT 协议开源,允许自由修改和集成到个人项目中。对于正在探索 OpenAI API 新特性并追求应用稳定性的前端或全栈开发者来说,这是一个非常友好的入门指南。
使用场景
某电商公司技术团队正在构建智能客服系统,需要自动从用户反馈中提取订单号、问题类型和紧急程度并录入工单系统。
没有 openai-structured-outputs-samples 时
- 大模型回复格式不稳定,偶尔返回纯文本或多余解释导致解析失败
- 需要编写大量正则表达式清洗数据,代码维护成本极高
- 遇到缺失关键字段时程序容易崩溃,严重影响生产环境稳定性
- 不同对话轮次间数据结构难以保持一致,后续集成工作繁琐
使用 openai-structured-outputs-samples 后
- openai-structured-outputs-samples 强制模型响应严格符合预定义的 JSON Schema 结构
- 提取的数据可直接对接后端数据库,完全省去了额外的清洗逻辑
- 即使模型未识别到具体信息也能按 Schema 返回默认空值,彻底避免运行时报错
- 基于仓库中的示例代码快速搭建多轮对话与工具调用流程,大幅缩短开发周期
通过强制输出规范,显著提升了应用的数据处理可靠性与开发效率。
运行环境要求
- 未说明
无需本地 GPU (依赖 OpenAI 云端 API)
未说明

快速开始
Structured Outputs(结构化输出)示例应用
Structured Outputs(结构化输出)是 OpenAI API 的一项功能,它确保响应和工具调用符合定义的 JSON 模式 (JSON schema)。 这使得使用我们的模型构建更加可靠,弥合了不可预测的模型输出与确定性工作流之间的差距。
此仓库包含一系列展示 Structured Outputs 用法的示例应用。
每个应用都展示了利用此功能构建 NextJS 应用的实用方法。
目录
如何使用
设置 OpenAI API:
克隆仓库:
git clone https://github.com/openai/structured-outputs-samples.git尝试一个示例应用:
- 导航到您想尝试的示例应用 (
cd /<app_folder>) - 参考该应用的 README 在本地运行它。
- 导航到您想尝试的示例应用 (
打造你自己的版本
探索代码,更新它,并在你自己的项目中使用它或作为起点!
示例应用
此仓库中有三个示例应用:
简历提取
这是一个简单的示例,展示如何在模型响应中使用 Structured Outputs 以结构化格式显示信息。

生成式 UI
此应用专注于使用 Structured Outputs 即时生成 UI 组件。

对话助手
这是一个更复杂的示例,结合了多轮对话、工具调用和生成式 UI。 您可以以此作为起点,构建具有可靠工作流的助手。

资源
要了解更多信息关于 Structured Outputs,请参阅 Structured Outputs 文档。
要了解有关 Function Calling(函数调用)的信息,请参阅 Function Calling 文档。
尝试 Structured Outputs 入门 Cookbook,进行动手实践并在 Python 中运行代码片段。
贡献
欢迎提交问题或提交 PR(拉取请求)以改进此应用,但请注意,我们可能不会审查所有建议。
许可
本项目采用 MIT 许可证。详细信息请参阅 LICENSE 文件。
常见问题
相似工具推荐
stable-diffusion-webui
stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面,旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点,将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师,还是想要深入探索模型潜力的开发者与研究人员,都能从中获益。其核心亮点在于极高的功能丰富度:不仅支持文生图、图生图、局部重绘(Inpainting)和外绘(Outpainting)等基础模式,还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外,它内置了 GFPGAN 和 CodeFormer 等人脸修复工具,支持多种神经网络放大算法,并允许用户通过插件系统无限扩展能力。即使是显存有限的设备,stable-diffusion-webui 也提供了相应的优化选项,让高质量的 AI 艺术创作变得触手可及。
everything-claude-code
everything-claude-code 是一套专为 AI 编程助手(如 Claude Code、Codex、Cursor 等)打造的高性能优化系统。它不仅仅是一组配置文件,而是一个经过长期实战打磨的完整框架,旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。 通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能,everything-claude-code 能显著提升 AI 在复杂任务中的表现,帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略,使得模型响应更快、成本更低,同时有效防御潜在的攻击向量。 这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库,还是需要 AI 协助进行安全审计与自动化测试,everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目,它融合了多语言支持与丰富的实战钩子(hooks),让 AI 真正成长为懂上
ComfyUI
ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎,专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式,采用直观的节点式流程图界面,让用户通过连接不同的功能模块即可构建个性化的生成管线。 这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景,也能自由组合模型、调整参数并实时预览效果,轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性,不仅支持 Windows、macOS 和 Linux 全平台,还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构,并率先支持 SDXL、Flux、SD3 等前沿模型。 无论是希望深入探索算法潜力的研究人员和开发者,还是追求极致创作自由度的设计师与资深 AI 绘画爱好者,ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能,使其成为当前最灵活、生态最丰富的开源扩散模型工具之一,帮助用户将创意高效转化为现实。
NextChat
NextChat 是一款轻量且极速的 AI 助手,旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性,以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发,NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。 这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言,它也提供了便捷的自托管方案,支持一键部署到 Vercel 或 Zeabur 等平台。 NextChat 的核心亮点在于其广泛的模型兼容性,原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型,让用户在一个界面即可自由切换不同 AI 能力。此外,它还率先支持 MCP(Model Context Protocol)协议,增强了上下文处理能力。针对企业用户,NextChat 提供专业版解决方案,具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能,满足公司对数据隐私和个性化管理的高标准要求。
ML-For-Beginners
ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程,旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周,包含 26 节精炼课程和 52 道配套测验,内容涵盖从基础概念到实际应用的完整流程,有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。 无论是希望转型的开发者、需要补充算法背景的研究人员,还是对人工智能充满好奇的普通爱好者,都能从中受益。课程不仅提供了清晰的理论讲解,还强调动手实践,让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持,通过自动化机制提供了包括简体中文在内的 50 多种语言版本,极大地降低了全球不同背景用户的学习门槛。此外,项目采用开源协作模式,社区活跃且内容持续更新,确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路,ML-For-Beginners 将是理想的起点。
ragflow
RAGFlow 是一款领先的开源检索增强生成(RAG)引擎,旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体(Agent)能力相结合,不仅支持从各类文档中高效提取知识,还能让模型基于这些知识进行逻辑推理和任务执行。 在大模型应用中,幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构(如表格、图表及混合排版),显著提升了信息检索的准确度,从而有效减少模型“胡编乱造”的现象,确保回答既有据可依又具备时效性。其内置的智能体机制更进一步,使系统不仅能回答问题,还能自主规划步骤解决复杂问题。 这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统,还是致力于探索大模型在垂直领域落地的创新者,都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口,既降低了非算法背景用户的上手门槛,也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目,它正成为连接通用大模型与行业专有知识之间的重要桥梁。