把 DeepSeek API 接进一个最小问答脚本

DeepSeek API 开放平台最实用的入门任务，可以先跑通一次“程序发一句话，模型回一句话”。第一天拿密钥，第三天接进终端脚本，一周后你会明白 API 调用到底在忙什么。

第一天，拿一把能开门的钥匙

新手先理解两个词。API 是接口，简单说就是程序之间互相打招呼的门；密钥是一串字符串，相当于门卡。没有门卡，门后面再大也进不去。

登录 DeepSeek 平台后，在左侧菜单找到 API Keys 或“创建 API 密钥”。点进去，在备注框输入 test-local，确认。页面会给你一串很长的密钥，一般会提醒只显示一次。

我踩的第一个坑，是把密钥截图发到群里问别人能不能用。这等于把门卡拍照群发。正确做法是立刻复制到本地，不要贴进聊天框，不要贴进公开仓库。

我习惯问一句，这个数据来源可靠吗。入门阶段的密钥管理，比模型能力更重要。

如果平台要求确认账户状态，先按页面提示完成，不要为了跑通就随便充值。第一天目标只有一个，拿到一串密钥，并确保它只存在你本机。

第三天，把门卡装进一个终端脚本

第三天我试着写一个最小脚本。假设你完全没碰过代码，我把术语拆开。

1. 新建一个文件，叫 ask.py。

2. 复制 DeepSeek 文档里的示例进去，先不改模型名。

3. 把示例里的 base_url 换成平台文档给出的 DeepSeek 地址。不要手敲，复制最稳。

4. 把密钥放到环境变量里，比如 DEEPSEEK_API_KEY，不要直接写死在代码里。

5. 在终端输入 python ask.py。如果提示找不到 python，先装 Python。

6. 看到光标等待时，输入一句“你好，请用一句话介绍自己”。

7. 预期结果，终端返回一段回答，不是报错，也不是空白。

最容易出错的是环境变量。很多人把密钥直接写进代码，一上传 GitHub 就泄露。更安全的写法是让程序从系统环境里读。比如 Python 示例里常见 os.environ["DEEPSEEK_API_KEY"]，意思就是去电脑环境里找那个名字的值。

第二个坑是兼容格式。DeepSeek API 文档提到，它使用与 OpenAI/Anthropic 兼容的 API 格式。听起来友好，但新手容易误解成随便哪个 SDK 都能原样跑。其实仍要改 base_url 和密钥。我一开始只改密钥，忘改地址，请求打到别的服务上，报错很迷惑。

一周后，你会看到“调用”背后的账本

一周后再看这个任务，感受不一样。第一次跑通时，你会觉得模型很神奇。连续问十几句后，你会开始关心另一件事，这句话被谁处理了，消耗了什么，日志留在哪里。

这像做调查。表面是一个答案，背后是一条链路。密钥、模型名、地址、请求内容、返回结果，每一步都能留痕。对开发者来说这是功能，对普通用户来说这是责任边界。

你可以顺手做三件小事，给密钥按用途分开，本地测试一个，线上程序一个；把每次请求的问题和返回结果存进本地文件，方便复盘；不确定的能力，别只看宣传，拿同一个问题去不同模型跑一遍，多方求证。

教程最后要解决的，是让程序学会安全地问话。

下一步别急着做 Agent。先做一个“问题清单”脚本，准备十句你真正关心的提问，让程序逐条调用，把答案、耗时、失败原因都记下来。能稳定跑完这十句，新手最容易掉的坑就绕过去了。