6. 配置 API Key

课程示例默认使用 DeepSeek 大模型，至少需要配置 DeepSeek 的 API Key。按实际需要也可以配置其他模型服务商。

6.1 获取 DeepSeek API Key

1. 打开 DeepSeek 开放平台：https://platform.deepseek.com/
2. 注册 / 登录账号
3. 进入 API Keys 页面，点击 创建 API Key
4. 复制生成的 key（形如 sk-xxxxxxxx），注意 key 只显示一次，请立即保存

DeepSeek 是新用户注册即送 500 万 tokens 额度，足够学完整套课程。

6.2 创建 .env 文件

在项目根目录（langgraph/）下新建 .env 文件，填入以下内容：

# ============================================
# 必填：课程示例默认使用 DeepSeek 模型
# ============================================
DEEPSEEK_API_KEY=sk-你的DeepSeek_API_Key

# ============================================
# 可选：其他模型服务商（如需切换模型时使用）
# ============================================
# OPENAI_API_KEY=sk-你的OpenAI_API_Key
# ANTHROPIC_API_KEY=sk-ant-你的Anthropic_API_Key

# ============================================
# 部署时需要（Ch 9 项目部署章节）
# ============================================
# LANGSMITH_API_KEY=lsv2-pt-你的LangSmith_API_Key
# LANGSMITH_TRACING=true
# LANGSMITH_ENDPOINT=https://api.smith.langchain.com
# LANGSMITH_PROJECT="langgraph-tutorial"

.env 文件已在 .gitignore 中排除，不会被提交到 Git，可以放心保存密钥。

6.3 代码中如何读取 .env

课程每个 notebook 或示例代码开头都会包含以下两行，自动加载 .env 中的密钥：

from dotenv import load_dotenv
load_dotenv(override=True)

之后创建模型客户端时，SDK 会自动从环境变量中读取对应的 API Key，无需在代码中硬编码：

from langchain_deepseek import ChatDeepSeek

# API Key 自动从 DEEPSEEK_API_KEY 环境变量读取
model = ChatDeepSeek(model="deepseek-v4-flash")