大二小白实测：大模型API调用保姆级教程（3个实用小工具，代码可直接复制）

大家好，我是一名大二计算机专业学生，纯小白起步，前段时间刚搞定大模型API调用。

之前一直有个误区：觉得API调用是“大佬专属”，需要懂复杂的后端知识，直到自己上手才发现——大模型API调用，本质就是“发请求、拿响应”，几行代码就能搞定，甚至比做Python作业还简单。

前后踩了不少坑：API Key配置错、请求参数乱填、代码跑不通、不知道怎么把API做成实用工具……折腾了几天，终于摸清了规律，还做了3个能直接用的小工具（文本翻译、文案生成、代码纠错）。

今天这篇教程，我用小白最能听懂的话，从“API是什么”到“3个工具实战”，全程无复杂术语、无多余废话，所有代码可直接复制运行，不管你是刚学Python，还是完全不懂AI，跟着做就能学会，还能亲手做出属于自己的小工具，期末作业、课程小项目都能直接用！

⚠️ 重点：不用懂深度学习、不用训模型，只要会复制代码、改参数，就能搞定！

一、先搞懂：大模型API到底是什么？（一句话秒懂）

大白话解释：API就是大模型厂商（OpenAI、百度文心一言等）给我们提供的“调用通道”——我们用代码给大模型发“指令”，大模型处理后，给我们返回“结果”，就像我们用微信发消息、收消息一样简单。

举个例子：

  • 你在ChatGPT网页版输入“帮我写一句文案”，这是“手动发指令”；

  • 用代码调用API，就是“让程序自动发指令”，大模型返回文案后，我们还能把结果整合到自己的小工具里（比如做个文案生成器）。

核心逻辑（记死，小白也能懂）：

  1. 我们有一个“API Key”（相当于“通行证”，没有它不能调用）；

  2. 用Python写几行代码，带上“通行证”和“指令”，给大模型发请求；

  3. 大模型收到请求，处理后返回结果；

  4. 我们把结果打印出来，或者做成可视化界面，就是一个小工具。

✅ 补充：新手不用纠结“API底层怎么实现”，就像我们用微信不用懂“基站怎么工作”一样，会用就行！

二、前置准备（2步搞定，小白零门槛）

不管调用哪个大模型（OpenAI、文心一言），都要先做这2步，一步都不能少，否则代码会报错！

第一步：安装必备库（一条命令搞定）

新建一个文件夹，打开终端（Windows用CMD，Mac/Linux用终端），输入以下命令，一键安装所有需要的库：

pip install openai python-dotenv requests

各库作用（小白不用记，知道就行）：

  • openai：调用OpenAI的大模型（GPT-3.5/4）；

  • python-dotenv：安全存放API Key，避免泄露；

  • requests：备用（如果不用openai库，用requests也能调用API，后面会讲）。

第二步：获取API Key（2种方式，新手选一种即可）

API Key是“调用大模型的通行证”，没有它，代码跑不通。这里给大家两种获取方式，新手优先选“文心一言”（不用科学上网，免费额度足够）。

方式1：文心一言API Key（推荐，国内可用，免费）

  1. 打开百度智能云官网（https://cloud.baidu.com/），注册/登录账号；

  2. 搜索“文心一言”，进入“文心一言API服务”页面；

  3. 领取免费额度（新手足够用），然后创建“应用”，就能获取「API Key」和「Secret Key」（两个都要保存好）；

  4. 注意：领取后，记得记录好两个Key，后面代码会用到。

方式2：OpenAI API Key（需要科学上网）

  1. 打开OpenAI官网（https://platform.openai.com/），注册/登录账号；

  2. 进入“Personal → View API keys”，创建一个新的API Key，复制保存（只能看一次，别弄丢）；

  3. 注意：OpenAI需要科学上网，新手如果不会，优先选文心一言。

关键操作：创建.env文件（保存API Key，避免泄露）

在代码同目录下，新建一个文本文件，重命名为「.env」（前面有个点，别漏了），打开后按下面格式填写（根据你选的大模型填写）：

👉 文心一言用户（填写这个）：

BAIDU_API_KEY=你的文心一言API Key
BAIDU_SECRET_KEY=你的文心一言Secret Key

👉 OpenAI用户（填写这个）：

OPENAI_API_KEY=你的OpenAI API Key

⚠️ 注意：.env文件不用运行，代码会自动读取里面的Key，这样做能避免Key泄露，小白一定要这么做！

三、基础实战：学会调用API（最核心，小白必练）

先从最简单的“调用大模型回答问题”开始，掌握基础用法，后面做工具就很简单。这里分别给出「文心一言」和「OpenAI」的代码，新手选自己的Key对应的代码，直接复制运行！

案例1：文心一言API调用（国内可用，不用科学上网）

新建文件，命名为「1_basic_baidu.py」，复制以下代码（不用改任何参数，除了.env里的Key）：

import os
from dotenv import load_dotenv
from langchain_community.chat_models import ChatBaiduERNIE

# 加载.env文件中的API Key（自动读取，不用手动输入）
load_dotenv()

# 1. 初始化文心一言大模型
llm = ChatBaiduERNIE(
    baidu_api_key=os.getenv("BAIDU_API_KEY"),
    baidu_secret_key=os.getenv("BAIDU_SECRET_KEY"),
    model_name="ernie-3.5",  # 新手用这个，免费额度足够，响应快
    temperature=0.1  # 0-1，越小越精准，越大越有创造性，新手设0.1即可
)

# 2. 编写要给大模型的指令（可以随便改，比如问问题、写文案）
prompt = "帮我写一句计算机专业课程的学习口号，简洁有力量，适合大学生"

# 3. 调用API，获取响应（核心步骤）
response = llm.invoke(prompt)

# 4. 打印结果（提取大模型的回答）
print("💡 大模型回答：")
print(response.content)

运行命令（终端输入）：

python 1_basic_baidu.py

✅ 成功效果：终端会打印出大模型生成的学习口号，比如“深耕代码，笃行致远，做新时代计算机人！”

⚠️ 常见报错：如果提示“API Key无效”，检查.env文件里的Key是否写错；如果提示“额度不足”，去百度智能云领取免费额度。

案例2：OpenAI API调用（需要科学上网）

新建文件，命名为「1_basic_openai.py」，复制以下代码：

import os
from dotenv import load_dotenv
from openai import OpenAI

# 加载.env文件中的API Key
load_dotenv()

# 1. 初始化OpenAI客户端
client = OpenAI(
    api_key=os.getenv("OPENAI_API_KEY")
)

# 2. 编写指令（和文心一言的指令完全一样，可通用）
prompt = "帮我写一句计算机专业课程的学习口号，简洁有力量，适合大学生"

# 3. 调用API，获取响应
response = client.chat.completions.create(
    model="gpt-3.5-turbo",  # 新手用这个，性价比高，免费额度足够
    messages=[
        {"role": "user", "content": prompt}  # 固定格式，不用改
    ],
    temperature=0.1
)

# 4. 打印结果
print("💡 大模型回答：")
print(response.choices[0].message.content)

运行命令：

python 1_basic_openai.py

✅ 成功效果：和文心一言类似，终端会打印出大模型的回答，说明API调用成功！

关键解释（小白必看）

  • temperature=0.1：新手固定设0.1，避免大模型瞎编；如果想让回答更有创造性（比如写文案），可以设0.7-0.9。

  • 指令（prompt）：可以随便改，比如“帮我解释Python的列表推导式”“帮我写一段简单的Python代码”，大模型都会按指令响应。

  • 两种代码逻辑完全一致，只是调用的库和参数不同，学会一种，另一种直接替换即可。

四、实战进阶：做3个实用小工具（可直接用，期末作业加分）

学会基础调用后，我们把API做成3个实用小工具——都是大学生能用到的，代码可直接复制，改改参数就能用，甚至能直接当课程小项目交！

工具1：文本翻译工具（中英互译，支持多语言）

用途：课程论文翻译、英文文献翻译，不用打开网页，直接在终端输入就能翻译，比百度翻译更精准（大模型翻译更贴合语境）。

新建文件，命名为「2_translation_tool.py」，复制以下代码（以文心一言为例，OpenAI用户可替换成上面的基础代码）：

import os
from dotenv import load_dotenv
from langchain_community.chat_models import ChatBaiduERNIE

# 加载API Key
load_dotenv()

# 初始化文心一言大模型
llm = ChatBaiduERNIE(
    baidu_api_key=os.getenv("BAIDU_API_KEY"),
    baidu_secret_key=os.getenv("BAIDU_SECRET_KEY"),
    model_name="ernie-3.5",
    temperature=0.1
)

def translation_tool(text, from_lang="中文", to_lang="英文"):
    """
    文本翻译工具
    :param text: 要翻译的文本
    :param from_lang: 原语言（默认中文）
    :param to_lang: 目标语言（默认英文）
    :return: 翻译后的文本
    """
    # 编写翻译指令（明确要求，让大模型精准翻译）
    prompt = f"""
    请你做一个专业的翻译助手，将以下{from_lang}文本翻译成{to_lang}，要求：
    1. 翻译准确，贴合原文语境，不添加额外内容；
    2. 保持原文的语气和风格（比如正式、口语化）；
    3. 只输出翻译结果，不输出任何多余解释。
    
    要翻译的文本：{text}
    """
    # 调用API
    response = llm.invoke(prompt)
    return response.content

# 交互界面（循环输入，输入q退出）
print("✅ 文本翻译工具已启动（输入q退出）")
print("支持：中文↔英文、中文↔日语、中文↔韩语等所有语言")
while True:
    text = input("\n请输入要翻译的文本：")
    if text.strip().lower() == "q":
        print("👋 退出工具，感谢使用！")
        break
    from_lang = input("请输入原语言（默认中文）：") or "中文"
    to_lang = input("请输入目标语言（默认英文）：") or "英文"
    result = translation_tool(text, from_lang, to_lang)
    print(f"\n💡 翻译结果（{from_lang}→{to_lang}）：")
    print(result)

运行命令：

python 2_translation_tool.py

✅ 使用效果：输入“计算机专业的学生需要掌握Python、Java等编程语言”，原语言选中文，目标语言选英文，就能得到精准翻译，直接复制可用！

工具2：文案生成工具（适配大学生场景）

用途：课程报告标题、社团活动文案、朋友圈文案、简历自我介绍，输入场景就能生成，不用自己绞尽脑汁。

新建文件，命名为「3_copywriting_tool.py」，复制以下代码：

import os
from dotenv import load_dotenv
from langchain_community.chat_models import ChatBaiduERNIE

# 加载API Key
load_dotenv()

# 初始化文心一言大模型
llm = ChatBaiduERNIE(
    baidu_api_key=os.getenv("BAIDU_API_KEY"),
    baidu_secret_key=os.getenv("BAIDU_SECRET_KEY"),
    model_name="ernie-3.5",
    temperature=0.7  # 文案生成需要一点创造性，设0.7
)

def copywriting_tool(scene, length="50字以内", style="简洁、正式"):
    """
    文案生成工具（适配大学生场景）
    :param scene: 文案场景（比如“课程报告标题”“社团招新文案”）
    :param length: 文案长度（默认50字以内）
    :param style: 文案风格（默认简洁、正式）
    :return: 生成的文案（3条，供选择）
    """
    prompt = f"""
    请你为大学生生成适配以下场景的文案，要求：
    1. 场景：{scene}
    2. 长度：{length}
    3. 风格：{style}
    4. 生成3条不同的文案，每条单独一行，不添加编号和多余解释；
    5. 贴合大学生的语气和需求，不使用过于官方、生硬的表达。
    """
    response = llm.invoke(prompt)
    return response.content

# 交互界面
print("✅ 文案生成工具已启动（输入q退出）")
print("适配场景：课程报告、社团招新、简历自我介绍、朋友圈文案等")
while True:
    scene = input("\n请输入文案场景（比如“课程报告标题”）：")
    if scene.strip().lower() == "q":
        print("👋 退出工具，感谢使用！")
        break
    length = input("请输入文案长度（默认50字以内）：") or "50字以内"
    style = input("请输入文案风格（默认简洁、正式）：") or "简洁、正式"
    result = copywriting_tool(scene, length, style)
    print(f"\n💡 生成的3条文案：")
    print(result)

运行命令：

python 3_copywriting_tool.py

✅ 使用效果：输入场景“社团招新文案（计算机社团）”，风格“活泼、有吸引力”，就能生成3条适配的招新文案，直接复制用在海报、朋友圈里！

工具3：代码纠错工具（大学生写作业必备）

用途：写Python作业时，代码报错不知道怎么改？把报错的代码和错误信息粘贴进去，大模型会帮你找出错误、修改代码，还会解释原因，比问老师、查百度更高效。

新建文件，命名为「4_code_fix_tool.py」，复制以下代码：

import os
from dotenv import load_dotenv
from langchain_community.chat_models import ChatBaiduERNIE

# 加载API Key
load_dotenv()

# 初始化文心一言大模型
llm = ChatBaiduERNIE(
    baidu_api_key=os.getenv("BAIDU_API_KEY"),
    baidu_secret_key=os.getenv("BAIDU_SECRET_KEY"),
    model_name="ernie-3.5",
    temperature=0.1  # 代码纠错要精准，设0.1
)

def code_fix_tool(code, error_info=""):
    """
    代码纠错工具（主要适配Python，其他语言也可）
    :param code: 报错的代码（完整粘贴）
    :param error_info: 终端显示的错误信息（可选，能让纠错更精准）
    :return: 错误原因 + 修改后的代码
    """
    prompt = f"""
    请你做一个专业的Python程序员，帮我纠错代码，要求：
    1. 先分析代码的错误原因，用简洁的中文解释（适合大学生理解）；
    2. 然后给出修改后的完整代码，代码要规范、有注释；
    3. 只针对代码中的错误修改，不改变代码的原始功能；
    4. 如果代码没有错误，直接说“代码无错误，可正常运行”。
    
    报错的代码：
    {code}
    
    错误信息（可选）：
    {error_info}
    """
    response = llm.invoke(prompt)
    return response.content

# 交互界面
print("✅ 代码纠错工具已启动（输入q退出）")
print("用法：粘贴报错的Python代码，可选粘贴错误信息，即可获取修改方案")
while True:
    print("\n请粘贴报错的Python代码（输入完毕后，按回车，再输入'over'结束）：")
    code_lines = []
    while True:
        line = input()
        if line.strip().lower() == "over":
            break
        code_lines.append(line)
    code = "\n".join(code_lines)
    if code.strip().lower() == "q":
        print("👋 退出工具，感谢使用！")
        break
    error_info = input("请粘贴终端显示的错误信息（可选，直接回车跳过）：")
    result = code_fix_tool(code, error_info)
    print(f"\n💡 纠错结果：")
    print("-" * 50)
    print(result)

运行命令：

python 4_code_fix_tool.py

✅ 使用效果：比如粘贴报错代码“print(“Hello World”)”（少写冒号），错误信息“SyntaxError: invalid syntax”，工具会解释“语法错误，print语句后缺少冒号”，并给出修改后的正确代码，还会加注释，小白能看懂、能直接用！

五、小白最容易踩的5个坑（我全踩过，帮你避坑）

  1. API Key写错/漏写：比如把.env文件里的Key写错一个字符，或者没创建.env文件，直接在代码里写Key，导致调用失败，一定要仔细核对Key。

  2. 没有科学上网（OpenAI用户）：用OpenAI的代码，没科学上网，会提示“网络错误”，要么科学上网，要么换文心一言。

  3. temperature设太大：做代码纠错、翻译时，temperature设0.8以上，导致结果不精准、瞎编，新手记住：精准类需求（纠错、翻译）设0.1，创意类需求（文案）设0.7-0.9。

  4. 指令太模糊：比如只写“帮我写文案”，没说场景、长度、风格，导致大模型生成的内容不符合预期，指令一定要具体（参考工具里的prompt模板）。

  5. 库没安装全：运行代码时提示“no module named ‘xxx’”，说明库没安装，重新执行第一步的pip命令，确保所有库都安装成功。

⚠️ 补充：如果代码报错，先看报错信息，大概率是上面5个问题中的一个，逐一排查就能解决，不用慌！

六、进阶拓展（小白学会基础后再学，提升竞争力）

学会这3个工具后，你已经比很多同年级的同学厉害啦！如果想进一步提升，可尝试以下拓展，适合做更复杂的课程项目：

  • 给工具加可视化界面：用Gradio库，做一个网页版工具，不用在终端输入，点击按钮就能用（后续我会更新教程）；

  • 整合多个功能：把翻译、文案生成、代码纠错整合到一个工具里，做成“大学生AI工具箱”；

  • 添加历史记录：让工具记住之前的输入和输出，方便后续查看；

  • 调用其他API：比如结合百度翻译API、天气API，做更复杂的工具（比如“翻译+天气查询”工具）。

七、最后我想说（大二学生真心话）

我刚开始学API调用时，也觉得很难，看到“请求”“响应”“参数”这些词就头疼，甚至跑了几十次代码都报错，差点放弃。

但后来发现，只要抓住“发请求、拿响应”这个核心，跟着代码一步步复制、运行，报错了就排查问题，慢慢就上手了——API调用真的不是大佬专属，小白也能轻松学会，关键是敢动手、敢试错。

这篇教程，我把自己踩过的坑、总结的经验，全部融入到代码和步骤里，就是希望和我一样的普通计算机学生，能少走弯路，不用再到处找碎片化教程，直接复制代码就能学会，还能做出实用的小工具。

学会大模型API调用，不仅能帮你搞定期末作业、课程项目，还能提升你的Python实战能力，以后找实习、找工作，这也是一个加分项。

如果在运行代码时遇到报错、不会获取API Key，或者想拓展更复杂的功能，欢迎在评论区交流，我会尽量回复，咱们一起踩坑、一起进步！

觉得有用的话，欢迎 点赞 + 收藏，我后面会继续更新小白友好的AI教程，帮大家从小白变大佬，轻松搞定AI相关的课程项目和实战需求！💪

# 人工智能 # python
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

▲基于Qlearning强化学习的DDoS攻防博弈算法matlab模拟和仿真

avatar AtomGit开源社区
cover

热：AI辅助开发、C++23落地与Rust竞争下的生存之道

avatar AtomGit开源社区
cover

那些刷榜第一的 AI Agent，为什么到了真实场景就不行了？

avatar AtomGit开源社区