OpenAI Cookbook：官方出品的 API 实战指南

OpenAI 官方维护的开源项目，Star 数超过 74,000，收录了大量使用 OpenAI API 的代码示例和实操指南。

这个项目叫 OpenAI Cookbook，由 OpenAI 官方团队维护。定位是一个代码示例库，帮开发者快速上手 OpenAI API 的各类用法。项目在 GitHub 上获得了超过 74,000 个 Star，是 OpenAI 生态中关注度最高的开源仓库之一。

覆盖内容

Cookbook 的内容覆盖面比较广。基础部分包括 Chat Completions、Embeddings、Image Generation 这些常用接口的调用方式，每个接口都配有专门的 Notebook，讲解请求参数的含义和返回结果的处理方法。

进阶部分涉及 Function Calling、Streaming 响应、Structured Outputs、Fine-tuning 模型微调等功能。这些能力在实际项目中使用频率很高，官方文档通常只给接口定义和参数列表，Cookbook 补充了完整的调用流程、参数组合的实验结果，以及容易踩坑的地方。

还有一些面向特定场景的示例：多模态输入处理、长文本摘要与分块策略、RAG 检索增强生成、对话系统搭建、Prompt Engineering 的各类技巧。这些示例把抽象的概念落地为可运行的代码，降低了上手难度。

每个示例都是 Jupyter Notebook 格式，可以直接运行，也能修改参数自己跑一遍验证。代码以 Python 为主，但思路不限于特定语言，用其他语言的开发者同样能从中获得参考。

实际使用感受

用下来有两个比较明显的优点。

第一是示例质量高。不是简单贴几个 API 调用就结束，每个 Notebook 都配有详细的文字说明，解释了每一步在做什么，常见的错误和注意事项也有标注。刚接触 OpenAI API 的开发者跟着走一遍，基本能理解各接口的使用逻辑。有过经验的人也可以直接跳到感兴趣的章节，把 Notebook 当作速查手册用。

第二是更新速度快。OpenAI 每次推出新模型或新功能，Cookbook 很快就会补上对应的示例代码。GPT-4o、Realtime API、Responses API 这些近期发布的能力，都能在库里找到可运行的完整示例。这也说明这个仓库的价值会持续积累，隔一段时间回来翻一翻，经常能发现新内容。

在线阅读

项目有在线版本，托管在 cookbook.openai.com，页面做了分类和搜索，比直接在 GitHub 里翻文件方便很多。不想克隆仓库的话，在线浏览就能满足大部分需求。

快速开始

使用前需要准备一个 OpenAI 账号和对应的 API Key。设置环境变量：

export OPENAI_API_KEY=<your API key>

也可以在项目根目录放一个 .env 文件，Notebook 启动时会自动读取。

许可证

项目采用 MIT 协议，商用、修改、分发都没有限制。

如果正在做 LLM 应用开发，这个仓库值得翻一翻。不一定每个示例都用得上，但遇到具体问题时过来查一查，往往能快速找到解法和思路。

仓库值得翻一翻。不一定每个示例都用得上，但遇到具体问题时过来查一查，往往能快速找到解法和思路。