全文速览复习专用精简版本文面向零编程基础的新手完整讲解如何用 Python 调用 DeepSeek V4 Pro 大模型 API。核心结论可直接背诵复习DeepSeek V4 Pro 完全兼容 OpenAI 接口规范使用官方openaiPython SDK 即可调用无需使用 Anthropic 专用库。接口配置三要素api_key密钥、https协议、/v1版本路径三者缺一不可。消息格式铁则必须以user角色开头user与assistant严格交替排列每条消息固定包含role和content两个字段。响应取值固定写法response.choices[0].message.content同时可通过usage字段查看 token 消耗。四大实战场景全覆盖单词翻译函数、少样本情感分类、文本续写生成、可连续对话的命令行聊天机器人。新手 90% 的报错都来自四类问题拼写笔误、协议 / 路径错误、消息顺序违规、输出长度限制对照排查即可快速解决。一、核心概念与 SDK 选型很多新手会疑惑调用 DeepSeek 为什么要导入openai库这是因为 DeepSeek 官方采用了 OpenAI 兼容的接口标准只要是支持 OpenAI 协议的 SDK 都可以直接对接不用单独开发新的工具库。Claude 与 DeepSeek API 核心对应表原 ClaudeAnthropic概念DeepSeek V4 Pro 对应写法作用说明from anthropic import Anthropicfrom openai import OpenAI导入官方客户端 SDKclient.messages.create()client.chat.completions.create()发起对话请求的方法response.content[0].textresponse.choices[0].message.content获取模型生成的文本内容input_tokens / output_tokensprompt_tokens / completion_tokens统计输入、输出的 token 消耗量消息必须 user/assistant 交替规则完全一致额外支持system角色构造对话上下文的规则二、基础环境搭建1. 安装依赖包只需要两个第三方库openai负责调用 APIpython-dotenv负责安全管理密钥。pip install openai python-dotenv2. 配置密钥文件在代码同级文件夹新建名为.env的文件写入你的 API 密钥不要加引号、不要留多余空格DEEPSEEK_API_KEY你的DeepSeek API密钥3. 初始化客户端这是所有代码的前置步骤初始化完成后即可复用客户端发起请求。from dotenv import load_dotenv from openai import OpenAI import os load_dotenv() api_key os.getenv(DEEPSEEK_API_KEY) client OpenAI( api_keyapi_key, base_urlhttps://api.deepseek.com/v1 )环境搭建步骤汇总表步骤序号操作内容关键注意事项1安装依赖库确保 pip 可用国内网络可加清华镜像源加速2创建.env文件文件名必须是.env不能是.env.txt和代码放同一文件夹3初始化客户端base_url必须带https和末尾/v1缺一不可三、消息格式规范消息列表messages是和大模型交互的核心载体相当于把对话历史按固定格式传给 AI。1. 基础结构每条消息是一个字典必须包含两个字段role消息角色只能是user用户说的话或assistantAI 的回复content消息的具体文本内容2. 单条消息示例单轮问答response client.chat.completions.create( modeldeepseek-v4-pro, max_tokens1000, messages[ {role: user, content: Dr Pepper 汽水用了哪些风味} ] ) print(response.choices[0].message.content)3. 多轮对话示例要让 AI 记住上下文就把历史对话按顺序放进列表里。messages [ {role: user, content: 你好今天过得怎么样}, {role: assistant, content: 你好我状态不错谢谢关心。今天有什么可以帮你的}, {role: user, content: 能给我讲一个雪貂的冷知识吗}, ]消息格式核心规则表规则项要求违规后果起始角色第一条消息必须是user直接报 400 参数错误角色顺序user和assistant必须严格交替不能连续出现相同角色报参数错误请求失败必填字段每条消息必须同时有role和content触发必填参数缺失报错列表格式整体是列表内部是字典语法错误代码无法运行四、响应对象结构解析调用 API 后返回的response是一个结构化对象除了文本内容还包含很多有用的元信息。核心取值代码# 获取AI生成的文本最常用 reply response.choices[0].message.content # 查看token消耗 print(response.usage)响应字段详解表字段路径含义用途response.id本次请求的唯一 ID排查问题时用于定位请求response.model实际响应的模型名称确认调用的模型是否正确response.choices[0].message.content模型生成的文本内容核心输出99% 的场景都用这个response.choices[0].finish_reason模型停止生成的原因正常结束为stop长度不足为lengthresponse.usage.prompt_tokens输入内容消耗的 token 数计算费用、控制成本response.usage.completion_tokens输出内容消耗的 token 数计算费用、判断是否被截断response.usage.total_tokens本次请求总消耗 token费用统计 小白记住一句话拿回复就写response.choices[0].message.content永远不会错。五、实战案例 1翻译函数封装一个通用的翻译函数传入单词和目标语言即可返回翻译结果分为基础版和进阶版。基础版带固定句式def translate(word: str, target_language: str) - str: response client.chat.completions.create( modeldeepseek-v4-pro, max_tokens100, messages[ { role: user, content: f把单词{word}翻译成{target_language}按这个格式回复:The word {word} translated into {target_language} is:翻译结果 } ] ) return response.choices[0].message.content # 测试 print(translate(hello, Chinese))进阶版只输出单词无多余内容def translate(word: str, target_language: str) - str: response client.chat.completions.create( modeldeepseek-v4-pro, max_tokens50, messages[ { role: user, content: f把单词{word}翻译为{target_language}只输出翻译后的单词不要任何多余文字 } ] ) return response.choices[0].message.content.strip() # 测试 print(translate(chicken, Italian))翻译函数版本对比表版本输出效果特点适用场景基础版带完整句式如The word hello translated into Chinese is: 苹果可读性强符合教程格式要求学习演示、格式化输出进阶版只返回纯单词如pollo简洁干净可直接用于后续逻辑程序调用、批量翻译六、新手高频报错与避坑指南这部分汇总了 90% 新手会遇到的错误对照排查可快速解决问题。常见报错排查对照表报错类型典型现象根本原因修复方案Missing credentials初始化客户端时报错提示缺少密钥没读到 API 密钥1. 检查.env文件位置和文件名 2. 确认环境变量名和代码一致 3. 临时直接传入api_key测试405 Method Not Allowed发起请求时报 405 错误base_url配置错误1. 协议改成https不能用http2. 末尾必须加上/v1NameError: name Ture is not defined聊天机器人循环报错布尔值拼写错误把Ture改成正确的True属性错误没有choice属性取回复时报错字段名少写了s改成choices[0]复数属性错误没有contect属性取内容时报错单词拼写错误改成content正确拼写变量名不一致报错追加消息时报NameError列表名单复数混用全程统一用messages复数输出为空 / 被截断少样本分类只输出一半max_tokens设置太小调大max_tokens留足冗余空间消息顺序报错提示角色违规连续出现相同角色 / 以 assistant 开头严格遵循 user→assistant 交替规则首条必须是 user语法错误SyntaxError代码直接标红无法运行字典用分号分隔、引号冲突1. 字典键值对用逗号分隔 2. f-string 内外引号错开七、进阶用法1. 文本续写预先写好半句话放进assistant角色里让模型接着往下生成适合写诗、补全句子。response client.chat.completions.create( modeldeepseek-v4-pro, max_tokens100, messages[ {role: user, content: 写一句优美的俳句}, {role: assistant, content: 春来再花开} ] ) print(response.choices[0].message.content)2. 少样本提示Few-shot在消息列表里放几组 “问题 - 答案” 示例引导模型按固定格式输出适合分类、标签提取等场景。messages [ {role: user, content: 我觉得AI配腌黄瓜可能有点过头了我刚买了个腌黄瓜造型的泳池浮圈}, {role: assistant, content: POSITIVE}, {role: user, content: 说真的谁会吃腌黄瓜啊这东西也太难吃了}, {role: assistant, content: NEGATIVE}, {role: user, content: 刚试了PickleCo的新出辣腌黄瓜我的味蕾都在开心跳舞仅输出POSITIVE或NEGATIVE} ] response client.chat.completions.create( modeldeepseek-v4-pro, max_tokens20, temperature0, messagesmessages ) print(response.choices[0].message.content)进阶技巧汇总表技巧名称核心作用实现关键最佳实践文本续写让模型承接指定内容继续生成预先写入 assistant 消息适合创作、补全、格式续写少样本提示约束输出格式提升任务准确率放入 2-3 组示例对话搭配temperature0可稳定输出temperature参数控制输出随机性0 最稳定1 最发散分类、提取任务设为 0创作类设为 0.7-1八、实战案例 2命令行多轮聊天机器人最终综合实战打造一个可以连续对话、自动记住上下文的命令行聊天机器人输入exit即可退出。完整代码def chatbot(): print( DeepSeek 聊天机器人 ) print(输入 exit 退出对话\n) messages [] while True: user_input input(你:) if user_input.lower() exit: print(对话结束) break # 把用户消息加入对话历史 messages.append({role: user, content: user_input}) # 调用API获取回复 response client.chat.completions.create( modeldeepseek-v4-pro, max_tokens1000, messagesmessages ) reply response.choices[0].message.content print(fAI:{reply}\n) # 把助手回复加入历史保留上下文 messages.append({role: assistant, content: reply}) if __name__ __main__: chatbot()聊天机器人核心逻辑表步骤功能代码逻辑1初始化打印欢迎语创建空的消息列表存储历史2接收用户输入用input()获取用户文字判断是否退出3追加用户消息把用户输入包装成 user 角色加入历史列表4调用 API把完整历史传给模型获取回复5展示并保存回复打印 AI 回复同时把回复加入历史列表6循环往复回到步骤 2实现持续多轮对话写在最后从最简单的单轮问答到封装函数、进阶技巧再到完整的多轮聊天机器人这就是 DeepSeek API 入门的全部核心内容。新手学习时建议按顺序实操先跑通单轮问答再写翻译函数接着尝试少样本和续写最后完成聊天机器人遇到报错直接对照第六部分的表格排查即可。
企业数字化 ERP 产品动态
相关推荐
18. 光刻机和半导体 EDA全流程签核:7nm及GAA环绕栅架构寄生参数高精度提取 Sorting Logic: English (Global Standard) → Chinese (Original Context) → German (Precision Engineering)
18. EDA Full-Flow Signoff: High-Accuracy Parasitic Extraction for 7nm & GAA Gate-All-Around Architectures
World-Class Hard Tech R&D Roadmap 202… · 2026/10/5 0:55:19
WSL2环境配置优化与性能调优指南 1. WSL2 环境配置基础 WSL2(Windows Subsystem for Linux 2)是微软推出的第二代Linux子系统,相比第一代采用了真正的Linux内核,提供了完整的系统调用兼容性。我在实际使用中发现,默认安装后的WSL2存在几个关键问题需要… · 2026/10/25 1:52:41
Windows Server 2022网卡驱动配置与性能优化指南 1. Windows Server 2022网卡驱动配置概述在服务器操作系统中,网卡驱动的正确安装与配置是确保网络连通性和性能的基础。Windows Server 2022作为微软最新的服务器操作系统,对硬件驱动支持有特定要求。不同于普通Windows系统,服务器环境对网络… · 2026/11/21 12:34:42
电工证讲座:学历不高怕报不上名?良心建议帮你搞懂报考流程 电工证讲座:学历不高怕报不上名?良心建议帮你搞懂报考流程 你是不是也这样想,学历不高,报电工证怕被拒?其实真不是你想的那样,电工证考试并没有学历门槛。今天就给你讲讲电工证讲座里的干货,尤其是 良心建议 ,让你少走弯路,顺利拿到证。… · 2026/11/22 13:37:31
高级电工证补贴政策多久拿证?怕被中介坑的你必须知道 高级电工证补贴政策多久拿证?怕被中介坑的你必须知道 你不知道去哪里报名,怕被中介坑,还担心高级电工证补贴政策到底值不值得考?其实, 多久拿证 和 补贴政策 都是可以查清楚的,关键是你得找对地方。别再被那些不靠谱的中介忽悠,… · 2026/11/22 13:37:31
莱西市低压电工证怎么考,上岗必备的报名避坑指南 莱西市低压电工证怎么考,上岗必备的报名避坑指南 你是不是也遇到过这种情况:想找莱西市低压电工证报名,结果一打问就被一堆中介绕晕了?现在找工作、上岗都得有证, 低压电工证是上岗必备… · 2026/11/22 13:37:31
低压电工证抖音文案怎么写?上岗必备别踩坑 低压电工证抖音文案怎么写?上岗必备别踩坑 怕考不过白交培训费?洛阳涧西区应届工程类毕业生,想通过低压电工证找到好工作,却不知道怎么选培训机构、怎么备考、怎么避免踩坑?别急,这篇文章给你说透低压电工证抖音文案怎么写,还有真实避坑经验、上岗必备… · 2026/11/22 13:37:31
电工证样本有效期多久拿证你真的了解吗 电工证样本有效期多久拿证你真的了解吗 工地太忙根本没时间复习考试,这是大多数郑州建筑工人的共同烦恼。电工证样本有效期是很多工人关心的问题,但很多人对多久拿证、证书补办流程、考试内容都不太清楚。今天我们就来聊聊这些真实的问题,帮助你在最短的时… · 2026/11/22 13:37:31
泗阳电工证体检上岗必备,外省证书如何转过来 泗阳电工证体检上岗必备,外省证书如何转过来 之前考的证在外省能不能转过来?这个问题几乎是每个打算在泗阳从事电工工作的人都会问。尤其是在现在,电工证作为 上岗必备… · 2026/11/22 13:36:30
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42
麻阳考电工证在哪里考内部消息你知道吗 麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42
麻阳考电工证在哪里考内部消息你知道吗 麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43
双极步进电机控制实战: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/21 15:19:37
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/21 15:19:30
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/21 15:19:32