零基础也能用上AI:手把手教你接入OpenAI API
大家好,我是掘金上常写教程的全栈工程师。最近不少刚入门的朋友问我:“现在大模型这么火,我能不能也试试?”其实我当初学的时候也是一头雾水——API怎么申请?代码怎么写?LangChain又是啥?今天这篇教程,就是专门为完全零基础的同学准备的。我们将从注册账号开始,一步步带你把OpenAI的能力接入自己的程序里,还会顺带了解几个热门关键词:LangChain、RAG、DeepSeek 和 Trae。
别担心,全程代码简单、概念清晰,跟着做就行!
一、OpenAI API 能做什么?
简单说,OpenAI API 就是你和 AI 模型(比如 GPT-4)对话的“电话线”。你通过程序发一段文字过去,它就能返回聪明的回答。你可以用它:
- 写文章、改文案
- 回答用户问题(比如客服机器人)
- 分析数据、生成摘要
- 结合数据库实现“会查资料”的 AI(这就是 RAG)
而我们要做的,就是学会“打电话”给它。
二、环境准备:三步搞定开发环境
第一步:获取 API Key
- 访问 https://platform.openai.com
- 注册/登录账号(需要绑定信用卡,但新用户有免费额度)
- 点击右上角头像 → View API keys → Create new secret key
- 复制这个 Key(形如
sk-xxxxxx),千万别泄露!
💡提示:建议创建
.env文件保存密钥,避免提交到 Git。
第二步:安装 Python 环境(推荐)
虽然 OpenAI 支持多种语言,但 Python 生态最成熟。确保你已安装 Python 3.8+:
python --version
如果没装,请先去 python.org 下载安装。
第三步:安装必要库
打开终端,运行:
pip install openai python-dotenv
openai:官方 SDK,用来调用 APIpython-dotenv:安全读取.env文件中的密钥
接着在项目根目录创建 .env 文件:
OPENAI_API_KEY=你的sk-xxxxxx密钥
三、第一个 API 调用:让 AI 打个招呼
新建一个 hello_ai.py 文件:
from openai import OpenAI
import os
from dotenv import load_dotenv
# 加载 .env 文件
load_dotenv()
# 初始化客户端
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
# 发送请求
response = client.chat.completions.create(
model="gpt-3.5-turbo", # 使用免费且快的模型
messages=[
{"role": "user", "content": "你好,请用一句话介绍你自己"}
]
)
# 打印 AI 的回答
print(response.choices[0].message.content)
运行:
python hello_ai.py
如果看到类似“我是由 OpenAI 开发的语言模型……”的回答,恭喜!你已经成功接入 AI!
🌟 我当初第一次跑通时超级兴奋——原来 AI 真的能被“编程”!
四、关键概念扫盲:LangChain、RAG、DeepSeek、Trae 是什么?
这些词听起来高大上,其实本质很简单:
| 名词 | 是什么? | 作用 |
|---|---|---|
| LangChain | 一个 Python/JS 库 | 帮你更方便地组合 AI、数据源、记忆等功能 |
| RAG(检索增强生成) | 一种技术思路 | 让 AI 先查资料再回答,避免“胡说八道” |
| DeepSeek | 国产大模型系列 | 类似 GPT 的中文模型,可本地部署或 API 调用 |
| Trae | 一款 AI 编程 IDE | 能自动写代码、解释逻辑,适合新手学习 |
🔍 重点理解 RAG:假设你问“公司去年营收多少?”,普通 AI 不知道,但 RAG 会先去你的财报 PDF 里找答案,再生成回复。
五、实战项目:用 LangChain + RAG 做一个“会查文档”的 AI 助手
我们来做一个小工具:上传一个文本文件,AI 能基于内容回答问题。
步骤 1:安装 LangChain 和向量库
pip install langchain langchain-openai faiss-cpu
langchain-openai:LangChain 对 OpenAI 的封装faiss-cpu:用于快速检索相似文本(向量搜索)
步骤 2:准备一份“知识库”
创建 knowledge.txt:
掘金是一个面向开发者的技术社区。
作者毕业于985高校,擅长全栈开发。
OpenAI API 可以通过 Python 调用。
步骤 3:编写 RAG 程序
创建 rag_bot.py:
from langchain_openai import ChatOpenAI, OpenAIEmbeddings
from langchain_community.document_loaders import TextLoader
from langchain_text_splitters import CharacterTextSplitter
from langchain_community.vectorstores import FAISS
from langchain.chains import RetrievalQA
import os
from dotenv import load_dotenv
load_dotenv()
# 1. 加载文档
loader = TextLoader("knowledge.txt", encoding="utf-8")
docs = loader.load()
# 2. 切分文本(避免太长)
text_splitter = CharacterTextSplitter(chunk_size=300, chunk_overlap=0)
texts = text_splitter.split_documents(docs)
# 3. 创建向量数据库(把文字转成数字向量)
embeddings = OpenAIEmbeddings()
db = FAISS.from_documents(texts, embeddings)
# 4. 构建检索问答链
llm = ChatOpenAI(model="gpt-3.5-turbo")
qa = RetrievalQA.from_chain_type(
llm=llm,
chain_type="stuff",
retriever=db.as_retriever()
)
# 5. 提问!
question = "作者是什么学历?"
result = qa.invoke({"query": question})
print("AI 回答:", result["result"])
运行后,你会看到 AI 准确回答:“作者毕业于985高校”。
✅ 这就是 RAG 的核心:先检索相关段落,再让 AI 基于段落生成答案,大幅减少幻觉。
六、新手常见问题解答
Q1:为什么我的 API 调用报错 “Invalid API Key”?
- 检查
.env文件是否在当前目录 - 确保密钥没有多余空格
- 确认你复制的是完整的
sk-...字符串
Q2:能不用 OpenAI 吗?国内有替代吗?
当然可以!比如 DeepSeek 提供了免费 API:
# DeepSeek 示例(需申请 API Key)
client = OpenAI(
api_key="你的-deepseek-key",
base_url="https://api.deepseek.com"
)
它的中文能力很强,而且响应快,适合国内开发者。
Q3:LangChain 太复杂了,一定要用吗?
不一定!如果你只是做简单问答,直接用 openai 库就够了。
LangChain 适合组合多个工具的场景(比如:查数据库 + 调用 API + 发邮件)。
Q4:Trae 是什么?和编程有关吗?
Trae 是一个新兴的 AI 编程助手(类似 GitHub Copilot),但它自带教学模式。
你写代码时,它不仅能补全,还能解释每一行的作用——非常适合边学边练。
七、下一步学习建议
你已经迈出了关键一步!接下来可以:
- 尝试不同模型:对比
gpt-3.5-turbo和gpt-4的效果差异 - 加入记忆功能:用 LangChain 的
ConversationBufferMemory实现多轮对话 - 部署到网页:用 Flask 或 Streamlit 快速做个 Web 界面
- 探索 DeepSeek:试试国产模型在中文任务上的表现
- 用 Trae 辅助学习:在写代码时让它实时讲解,加速理解
🚫 避坑指南:不要一上来就啃 LangChain 源码!先用它做小项目,再回头看原理。
结语
AI 不再是遥不可及的黑科技。只要你会写几行代码,就能让它为你工作。我当初也是从“Hello AI”开始,一步步做到现在的智能系统。希望这篇教程能成为你的起点。
记住:所有复杂的系统,都始于一个简单的请求。
动手试试吧!遇到问题欢迎在评论区留言,我会尽力解答。

评论 0