教程 · 2026-10-16

DeepSeek API Python 快速入门：十分钟跑通初次对话

本文带你用 Python 在十分钟内跑通 DeepSeek API 的初次调用：申请密钥、安装 SDK、发起对话、流式输出。接口与 OpenAI 格式兼容，也提供 Anthropic 格式端点，从其他模型迁移的成本很低。

准备工作

• 在 DeepSeek 开放平台注册账号并完成充值（新用户通常有赠送额度，以平台页面为准）；
• 创建 API key，保存到环境变量，不要提交进代码仓库。

export DEEPSEEK_API_KEY="sk-..."

安装 SDK 并发起调用

官方接口兼容 OpenAI 格式，直接用 openai 库即可：

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)

resp = client.chat.completions.create(
    model="deepseek-flash",   # DeepSeek-V4.1-Flash
    messages=[
        {"role": "system", "content": "你是一个简洁的中文助手。"},
        {"role": "user", "content": "用一句话介绍错峰计价。"},
    ],
)
print(resp.choices[0].message.content)

需要更强推理时可换 deepseek-v4-pro；视觉输入把图片放进 messages 即可，参考视觉 API 教程。

流式输出

stream = client.chat.completions.create(
    model="deepseek-flash",
    messages=[...],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Anthropic 格式端点

习惯 Anthropic SDK 的团队可以把 base_url 指向 https://api.deepseek.com/anthropic，模型名不变，迁移只需改两行配置。

三个常见坑

• 模型名写错：当前调用名为 deepseek-flash 与 deepseek-v4-pro，旧名仍可用但已映射到新模型；
• 费用超预期：峰时（北京时间工作日 09:00–12:00、14:00–18:00）单价是谷时两倍，批量任务尽量安排在夜间与周末，参见省钱指南；
• 默认思考模式：模型默认开启思考模式，简单任务可按官方文档切换以加快响应。

完整的价目与时段规则见峰谷计价详解。