想直接上手大模型 API：OpenAI 官方文档+Cookbook

很多人写代码用 GPT 的姿势是「Bing 搜一段、改一改、能跑就完事」。这种偷懒方式的问题在于：你不知道官方到底推荐什么写法，也不知道有什么新功能(比如 Function Calling、Vision)能用。直接读 OpenAI 官方文档，效率反而高。

文档和 Cookbook 各自的作用

• 官方文档讲「规则和概念」——参数、限制、最佳实践
• Cookbook 讲「真实场景怎么写」——客服机器人、PDF 总结、搜索增强
• API 参考页是「字典」——某个参数叫什么、能填什么值
• 更新很及时，新功能上线当天文档就出

推荐的阅读路径

1. 1打开 Quickstart,在网页上用 Playground 跑一次「让模型回答问题」
2. 2用代码跑通官方给的 quickstart 例子(不写 key 跑不通，所以先注册)
3. 3读 Prompt Engineering Guide 这一节，看官方推荐什么写法
4. 4翻 Cookbook 仓库目录，挑一个跟你工作相关的例子抄一遍

• 以为「官方文档只能从头读」——可以从当前任务对应的指南和示例开始，语言版本以页面为准
• 以为「Cookbook 必须全部看完」——它是场景集合，按需查就行
• 以为「API 用法只有一个 chat 接口」——还有 embeddings、function calling、vision 等十几个

用 Claude 的看 Anthropic 文档：如果你的主模型是 Claude,或者想看另一个大厂的最佳实践，接 Anthropic 官方文档，写法上跟 OpenAI 有微妙差异。