首页/新闻资讯/正文详情

零基础入门大模型API调用:从Jupyter环境搭建、密钥安全存储到Claude与DeepSeek双平台完整实战教程

发布时间:2026/11/21 12:26:36 来源:云帆数科 栏目:资讯中心
零基础入门大模型API调用:从Jupyter环境搭建、密钥安全存储到Claude与DeepSeek双平台完整实战教程
【全文速览・精简复习版】运行环境需 Python ≥ 3.7.1执行jupyter notebook启动本地服务在浏览器中逐段编写运行代码非常适合新手调试。依赖安装Claude 平台安装anthropic官方包DeepSeek 平台安装openaipython-dotenv包Notebook 内统一使用%pip魔法命令安装。密钥管理禁止将密钥硬编码在代码中统一存入笔记本同级目录的.env文件通过load_dotenv()读取从根源避免密钥泄露。调用流程初始化客户端 → 传入模型名称、最大输出长度、对话内容 → 发送请求 → 提取并打印 AI 返回文本。平台差异DeepSeek 兼容 OpenAI 接口格式必须额外指定base_urlhttps://api.deepseek.com调用方法与返回字段和 Claude 原生 SDK 不同。避坑准则.env真实后缀不能是.txt、密钥与接口地址必须一一对应、修改.env后需重启 Jupyter 内核才能生效。一、前置环境准备大模型 API 调用的代码运行在 Python 环境中入门阶段推荐使用 Jupyter Notebook 作为开发工具。它支持单元格逐段运行、即时查看输出结果无需一次性写完所有代码非常适合新手分步调试学习。1.1 Python 版本要求Claude Python SDK 要求 Python 版本不低于 3.7.1DeepSeek 兼容接口同样支持该版本及以上。 你可以在终端 / 命令行中执行以下命令查看当前的 Python 版本python --version如果版本不达标前往 Python 官方网站下载安装对应版本即可。1.2 Jupyter Notebook 启动方法打开 PowerShell 或 CMD执行jupyter notebook命令启动本地服务浏览器会自动打开文件管理页面默认地址为http://localhost:8888点击页面右上角「New → Python 3」即可新建一个空白笔记本开始编写代码【知识点汇总表前置环境要求】项目要求说明验证 / 操作命令Python 版本≥ 3.7.1python --versionJupyter 安装包含在 jupyter 元包中一键安装全套组件jupyter notebook启动服务工作目录命令行所在文件夹即为 Notebook 默认根目录cd 目标路径切换目录后再启动二、依赖包安装不同的大模型平台需要安装对应的 SDK 工具包在 Notebook 环境和终端环境安装命令也有细微区别。2.1 Notebook 专属安装方式在 Jupyter Notebook 的代码单元格中使用%pip魔法命令安装包可以保证包安装到当前 Notebook 对应的 Python 环境中避免出现 “终端安装成功但代码里导入失败” 的环境不一致问题。 如果是普通命令行开发则直接使用pip install命令。2.2 不同平台对应的依赖包Claude 官方平台使用官方专属 SDK 包anthropic封装了完整的 Claude 接口规范DeepSeek 平台接口完全兼容 OpenAI 格式直接使用openai包即可调用无需额外安装专属 SDK两个平台都推荐搭配python-dotenv包用来安全读取本地存储的 API 密钥【知识点汇总表依赖包安装命令】适用平台Notebook 内安装命令终端安装命令作用说明Claude 官方%pip install anthropicpip install anthropicClaude 官方 SDK用于调用 Claude 全系列模型DeepSeek%pip install openai python-dotenvpip install openai python-dotenvopenai 用于兼容调用 DeepSeekdotenv 用于读取密钥通用密钥工具%pip install python-dotenvpip install python-dotenv加载 .env 文件实现密钥与代码分离三、API 密钥获取与安全存储API 密钥就像是调用大模型服务的 “专属通行证”平台通过密钥识别你的账号身份、扣减调用额度因此必须像密码一样妥善保管。3.1 密钥获取通用步骤以 Claude 官方平台为例DeepSeek 等绝大多数平台逻辑完全一致前往对应平台官网注册账号Claudehttps://console.anthropic.comDeepSeekDeepSeek登录后进入个人设置中的「API Keys」页面点击「创建密钥」给密钥起一个能区分用途的名称生成后立刻完整复制保存关闭页面后将无法再次查看完整密钥3.2 为什么不能直接写在代码里新手最容易犯的错误就是把密钥直接写在代码里。一旦把代码分享给他人、上传到公开仓库密钥就会泄露别人可以盗用你的账号额度造成财产损失。 行业通用的最佳实践是密钥与代码分离存放使用.env配置文件单独存储敏感信息。3.3 .env 文件创建与配置在你的.ipynb笔记本同级文件夹下新建一个名为.env的文件Windows 注意必须开启文件夹的「文件扩展名」显示避免文件名实际变成.env.txt否则程序无法识别该文件在文件中按照「变量名 密钥值」的格式写入内容等号两侧不要加空格、不要加引号# Claude 平台变量名 ANTHROPIC_API_KEY你的Claude完整密钥 # DeepSeek 平台变量名 DEEPSEEK_API_KEY你的DeepSeek完整密钥保存文件即可3.4 用 python-dotenv 读取密钥通过load_dotenv()函数可以把.env里的配置加载到程序环境中再通过os.getenv()取出对应密钥。from dotenv import load_dotenv import os load_dotenv() my_api_key os.getenv(DEEPSEEK_API_KEY)【知识点汇总表密钥管理核心要点】操作项规范要求常见错误存储方式单独存入.env文件与代码分离直接把密钥写在代码里硬编码文件位置与.ipynb笔记本放在同一文件夹放在其他目录程序找不到文件文件命名严格命名为.env命名为.env.txtWindows 隐藏后缀坑内容格式变量名密钥等号两侧无空格等号两侧加空格、密钥前后带换行 / 空格生效时机修改文件后需重启 Jupyter 内核修改后直接运行读取的还是内存中的旧值四、第一次 API 请求完整流程拆解调用大模型的核心逻辑非常固定一共分为三步创建客户端 → 构造请求参数 → 发送请求并提取结果。4.1 Claude 官方 SDK 完整示例步骤 1导入包并加载密钥from dotenv import load_dotenv import os from anthropic import Anthropic load_dotenv() my_api_key os.getenv(ANTHROPIC_API_KEY)步骤 2创建客户端客户端是你和大模型服务器交互的 “中转站”所有请求都通过它发送和接收。# 写法1手动传入密钥变量 client Anthropic(api_keymy_api_key) # 写法2SDK自动读取环境变量 ANTHROPIC_API_KEY无需手动传参 client Anthropic()步骤 3发送请求并打印结果our_first_message client.messages.create( modelclaude-3-haiku-20240307, max_tokens1000, messages[ {role: user, content: Hi there! Please write me a haiku about a pet chicken} ] ) print(our_first_message.content[0].text)4.2 DeepSeek 兼容接口完整示例DeepSeek 没有独立的 Python SDK它完全兼容 OpenAI 的接口格式因此使用openai包即可调用只需要额外指定接口地址。from dotenv import load_dotenv import os from openai import OpenAI load_dotenv() my_api_key os.getenv(DEEPSEEK_API_KEY) # 初始化客户端必须指定 base_url client OpenAI( api_keymy_api_key, base_urlhttps://api.deepseek.com ) # 发送请求 response client.chat.completions.create( modeldeepseek-v4-pro, max_tokens1000, messages[ {role: user, content: 你好请给我讲一个笑话} ] ) # 打印结果 print(response.choices[0].message.content)【知识点汇总表API 调用核心参数】参数名作用说明示例值model指定调用的具体模型名称必须与平台官方完全一致claude-3-haiku-20240307/deepseek-v4-promax_tokens限制 AI 输出的最大长度避免消耗过多额度1000messages对话消息列表采用「角色 内容」的结构化格式[{role: user, content: 提问内容}]role消息角色分为用户 user 和 AI 助手 assistantusercontent具体的对话文本内容自定义提问文本五、Claude 与 DeepSeek 调用规则完整对比5.1 为什么写法不一样Claude 使用官方自研的 SDK接口规范由 Anthropic 官方独立定义功能更贴合自身模型特性DeepSeek 采用了行业通用的 OpenAI 兼容接口可以直接复用 OpenAI 生态的所有工具和代码大幅降低开发者的学习和迁移成本【知识点汇总表双平台调用差异对比】对比维度Claude 官方 SDKDeepSeekOpenAI 兼容格式导入包语句from anthropic import Anthropicfrom openai import OpenAI客户端类名Anthropic()OpenAI()接口地址配置内置默认地址无需手动配置必须手动配置base_urlhttps://api.deepseek.com核心调用方法client.messages.create()client.chat.completions.create()自动识别的环境变量自动识别ANTHROPIC_API_KEY无默认值需自定义变量名传入提取返回文本response.content[0].textresponse.choices[0].message.content消息列表参数名messagesmessages长度限制参数名max_tokensmax_tokens六、入门实战练习让 AI 讲笑话对应课程的课后练习任务只需要修改content里的提问内容就能实现不同的交互效果。6.1 Claude 版本from dotenv import load_dotenv import os from anthropic import Anthropic load_dotenv() my_api_key os.getenv(ANTHROPIC_API_KEY) client Anthropic(api_keymy_api_key) response client.messages.create( modelclaude-3-haiku-20240307, max_tokens1000, messages[ {role: user, content: 请给我讲一个笑话} ] ) print(response.content[0].text)6.2 DeepSeek 版本from dotenv import load_dotenv import os from openai import OpenAI load_dotenv() my_api_key os.getenv(DEEPSEEK_API_KEY) client OpenAI(api_keymy_api_key, base_urlhttps://api.deepseek.com) response client.chat.completions.create( modeldeepseek-v4-pro, max_tokens1000, messages[ {role: user, content: 请给我讲一个笑话} ] ) print(response.choices[0].message.content)七、新手高频踩坑排查指南入门阶段最容易遇到的报错几乎都集中在几类低级错误对照下表可以快速定位并解决问题。【知识点汇总表报错排查速查表】报错类型报错关键词常见原因解决方法参数缺失错误Missing required argument参数名拼写错误比如message漏写 s、max_token漏写 s核对参数名确保为复数形式messages、max_tokens鉴权失败错误401 AuthenticationError密钥无效、密钥与接口地址不匹配、密钥复制不全核对密钥有效性确认密钥和 base_url 属于同一平台重新完整复制密钥密钥读取失败打印密钥为None.env文件位置不对、文件名实际为.env.txt、内容格式错误检查文件位置和名称确认等号两侧无空格重启内核语法错误SyntaxError引号、括号不配对使用了中文标点符号检查所有符号均为英文半角确认括号成对闭合模块导入失败ModuleNotFoundError包未安装或安装到了其他 Python 环境在 Notebook 内用%pip重新安装对应包模型不存在model not found模型名称拼写错误到对应平台官网核对准确的模型名称

相关推荐

HarmonyOs应用《重要日》开发第20篇 - Swiper + LazyForEach 实现日历无限滚动
HarmonyOs应用《重要日》开发第20篇 - Swiper + LazyForEach 实现日历无限滚动

本文深入解析 ImportantDays 项目中日历无限滚动的实现方案,探讨 Swiper 组件与 LazyForEach 的配合使用、IDataSource 接口的实现、数据动态追加/前插策略,以及在鸿蒙应用中实现高性能无限滚动的最佳实践。一、无限滚动的需求 日历应用需要支持用户左右… · 2026/11/21 12:26:35

HarmonyOs应用《重要日》开发第19篇 - EntryAbility 应用入口与生命周期管理
HarmonyOs应用《重要日》开发第19篇 - EntryAbility 应用入口与生命周期管理

本文深入解析 ImportantDays 项目中的应用入口 EntryAbility,包括 UIAbility 的生命周期回调、初始化流程(Preferences → Manager → 通知检查)、窗口管理、前台提醒检查机制,以及应用配置的关联关系。一、UIAbility 概述 UIAbil… · 2026/9/23 15:54:12

SolidWorks_钣金设计18_钣金工程图规范
SolidWorks_钣金设计18_钣金工程图规范

钣金工程图规范:标注展开图、折弯线、折弯角度及下料尺寸的完整指南 摘要 钣金工程图是连接设计意图与制造工艺的核心技术文档。本文系统性地阐述了钣金工程图的规范标注方法,重点涵盖展开图的绘制与标注、折弯线的精确表达、折弯角度的标准标注以及下料… · 2026/9/23 15:54:05

长垣有没有办电工证的,真实经历告诉你怎么考、怎么干、怎么赚
长垣有没有办电工证的,真实经历告诉你怎么考、怎么干、怎么赚

长垣有没有办电工证的,真实经历告诉你怎么考、怎么干、怎么赚 学历不高怕报不上名,这事儿我懂,当年我就是个初中毕业的,愣是考上了电工证,现在拿着证在工地干活,一个月也能挣七八千,说白了,只要你愿意学、愿意干,电工证这事儿真不难。… · 2026/11/21 12:26:27

哈尔滨电工证复审电话怎么查?网上查询全攻略来了
哈尔滨电工证复审电话怎么查?网上查询全攻略来了

哈尔滨电工证复审电话怎么查?网上查询全攻略来了 证书过期了不知道怎么复审延期?别急,哈尔滨电工证复审电话其实不难找,关键是你得知道怎么网上查询。如果你是电工,或是正在从事相关工作的朋友,这张证书不仅是职业资格的证明,更是上岗作业的“通行证”… · 2026/11/21 12:26:27

南京电工证焊工证电子证书过期怎么复审
南京电工证焊工证电子证书过期怎么复审

南京电工证焊工证电子证书过期怎么复审 证书过期了不知道怎么复审延期,这事儿不少电工、焊工都遇到过。很多人以为证书一过期就作废了,其实只要及时办理复审,照样能继续使用。特别是在南京地区,不少从业人员对【南京电工证焊工证】的电子证书流程并不熟悉… · 2026/11/21 12:26:27

东营去哪里考电工证好 电工证怎么考才能顺利通过网上查询
东营去哪里考电工证好 电工证怎么考才能顺利通过网上查询

东营去哪里考电工证好 电工证怎么考才能顺利通过网上查询 工地太忙根本没时间复习考试,这是很多一线电工的共同痛点。尤其是在东营,工地项目多、工期紧,很多人一边扛着活干,一边还得想着怎么去考电工证。网上查资料、找培训机构、报班学习,看似简单,其… · 2026/11/21 12:26:27

东营去哪里考电工证好?真实经历告诉你怎么避开坑
东营去哪里考电工证好?真实经历告诉你怎么避开坑

东营去哪里考电工证好?真实经历告诉你怎么避开坑 工地太忙根本没时间复习考试,这几乎是每个想考电工证的建筑工人心里的痛。尤其是像我这样刚来东营打工的新人,每天在工地搬砖、扛水泥,晚上还得加班,根本没有时间准备考试。我之前也是在网上乱搜“东营去… · 2026/11/21 12:26:27

临沂电工证怎样年审 你的证还能用吗 值不值得考
临沂电工证怎样年审 你的证还能用吗 值不值得考

临沂电工证怎样年审 你的证还能用吗 值不值得考 之前考的证在外省能不能转过来?这是很多电工朋友心里最担心的问题。临沂电工证怎样年审?很多人拿着证却不知道怎么操作,甚至担心过期失效。如果你正在纠结“值不值得考”,这篇文章给你一个清晰的解答。… · 2026/11/21 12:25:27

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

电工证征求意见2026河南最新政策怎么应对?学历不高也能考!
电工证征求意见2026河南最新政策怎么应对?学历不高也能考!

电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17

房建企业特种工考前押题怎么找?别让培训费打了水漂
房建企业特种工考前押题怎么找?别让培训费打了水漂

房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码