视频加载失败

通过调用API使用大模型

1160 字
6 分钟
通过调用API使用大模型

操作过程中遇到的问题,可以查看我的文章《通过调用API使用大模型问题及解决》

一、安装依赖#

1. 安装Python#

打开官网Python安装,根据电脑系统(Windows/macOs等)下载 Python 。

Python安装
Python安装

Python 自带 pip包管理

2. 安装OpenAi#

pip install openai

3. 安装load_dotenv#

load_dotenv 并不是 Python 的内置模块,而是第三方库 ‌python-dotenv‌ 中的一个核心函数。要使用它,你需要先安装该库。

pip install python-dotenv
// 或 pip3 install python-dotenv

验证安装是否成功:#

在 Python 交互环境中输入以下代码,若无报错则说明安装成功:

from dotenv import load_dotenv

注意‌:包名是 python-dotenv,而不是 dotenv。如果执行 pip install dotenv 可能会安装错误的包或导致冲突。

二、准备DeepSeek API key#

创建deepseek API keys

注意:API key创建的弹框一定要先点击复制,关闭弹框后无法复制API key。

三、快速上手使用#

参考deepseek API文档

3-1 第一步:创建 .env 文件#

在项目的根目录下创建一个名为 .env 的文件(注意前面有点),并在其中定义环境变量,格式为 KEY=VALUE

# .env 文件内容
DATABASE_URL=postgresql://user:password@localhost/mydb
API_KEY=sk-1234567890abcdef
DEBUG=True

3-2 第二步:在 Python 代码中加载#

在你的 Python 脚本(通常是入口文件,如 main.py 或 app.py)的‌最顶部‌导入并调用 load_dotenv()。

import os
from dotenv import load_dotenv
# 1. 加载 .env 文件中的变量到当前环境
# 默认查找当前工作目录下的 .env 文件
load_dotenv()
# 2. 通过 os.getenv 读取变量
db_url = os.getenv("DATABASE_URL")
api_key = os.getenv("API_KEY")
debug = os.getenv("DEBUG")
print(f"Database: {db_url}")
print(f"API Key: {api_key}")
print(f"Debug Mode: {debug}")

3-2-1 扩展1:load_dotenv高级用法与常见场景#

3-2-1-1 指定 .env 文件路径#

如果 .env 文件不在当前工作目录,或者你想加载特定名称的文件(如 .env.prod),可以显式指定路径:

from pathlib import Path
from dotenv import load_dotenv
# 方法 A: 直接指定字符串路径
load_dotenv(dotenv_path="/path/to/your/.env.production")
# 方法 B: 基于当前脚本位置动态查找(推荐,更稳健)
env_path = Path(__file__).parent / ".env"
load_dotenv(dotenv_path=env_path)
3-2-1-2 强制覆盖系统环境变量#

默认情况下,如果系统中已经存在同名环境变量(例如在服务器部署时设置了 DATABASE_URL),load_dotenv() ‌不会‌覆盖它们。如果你希望 .env 文件的值优先,可以设置 override=True

# .env 中的值将覆盖系统中已存在的同名变量
load_dotenv(override=True)
3-2-1-3 多环境配置切换#

你可以为不同环境创建不同的文件(如 .env.dev, .env.prod),并根据系统变量动态加载:

import os
from dotenv import load_dotenv
# 获取当前环境标识,默认为 dev
env = os.getenv("ENV", "dev")
# 动态加载对应的配置文件,例如 .env.dev 或 .env.prod
load_dotenv(f".env.{env}")
3-2-1-4 仅读取而不注入环境变量#

如果你只想获取配置字典,而不想污染 os.environ,可以使用 dotenv_values

from dotenv import dotenv_values
config = dotenv_values(".env")
print(config["DATABASE_URL"])

3-2-2 扩展2<最佳实践与安全规范>#

3-2-2-1 ‌严禁提交 .env 到 Git‌#

.env 文件通常包含密码、密钥等敏感信息。务必在项目根目录的 .gitignore 文件中添加以下内容

.env
.env.*

3-2-2-2 ‌提供示例文件‌#

为了方便团队协作,建议创建一个 .env.example 或 .env.template 文件,其中包含所有必要的键名,但值为空或为示例数据。将此文件提交到 Git,团队成员克隆项目后复制该文件并重命名为 .env 再填写真实值。

.env.example
DATABASE_URL=
API_KEY=
DEBUG=False

3-2-2-3 调用顺序至关重要‌#

务必在执行任何读取环境变量的代码‌之前‌调用 load_dotenv()。如果在导入其他模块时那些模块立即读取了环境变量,而当时尚未加载 .env,则会读取不到值(返回 None)。

3-2-2-4 处理特殊字符#

如果变量值中包含空格、井号 # 或其他特殊字符,建议使用双引号包裹

SECRET_KEY="my secret key with spaces"
COMMENTED_VALUE="value # not a comment"

3-3 最终版demo.py#

# Please install OpenAI SDK first: `pip3 install openai`
import os
# python3 -m pip install python-dotenv 或 python -m pip install python-dotenv 或 pip install openai 或 pip3 install openai
from openai import OpenAI
# python3 -m pip install python-dotenv 或 python -m pip install python-dotenv 或 pip install python-dotenv 或 pip3 install python-dotenv 或
from dotenv import load_dotenv
# 加载.env文件的 DEEPSEEK_API_KEY="你申请的sk-xxx"
load_dotenv()
# os.environ.get 从环境变量中获取API key
# client = OpenAI(
# api_key=os.environ.get('DEEPSEEK_API_KEY'),
# base_url="https://api.deepseek.com",
# )
# os.getenv 从当前项目的.env文件中获取API key
client = OpenAI(
api_key=os.getenv('DEEPSEEK_API_KEY'),
base_url="https://api.deepseek.com",
)
response = client.chat.completions.create(
model="deepseek-v4-pro",
messages=[
{"role": "system", "content": "You are a helpful assistant"},
{"role": "user", "content": "你好,我是谁"},
]
)
print(response.choices[0].message.content)

如果你用的是VSCode,运行python(demo.py)文件需要安装python插件

VSCode安装python插件
VSCode安装python插件

安装完插件后,鼠标右键选择Run Python File in Terminal,控制台就会输出运行结果

运行结果
运行结果

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或打赏支持!

打赏
通过调用API使用大模型
https://gaodaxiu-blog.netlify.app/posts/guide/2通过调用api使用大模型/
作者
MuZhao
发布于
2026-10-18
许可协议
CC BY-NC-SA 4.0
Profile Image of the Author
MuZhao
Hello, I'm GaoDaXiu.
公告
欢迎来到我的博客!
分类
标签
最新动态
站点统计
文章
124
分类
25
标签
147
总字数
180,592
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
Netlify CI
博客版本
Firefly v6.16.8
文章许可
CC BY-NC-SA 4.0
文章目录