DeepSeek V4.1 Flash API 指南：最小请求与兼容检查

**2026-09-10 更新：**DeepSeek V4.1 Flash 已发布，推荐使用 deepseek-flash。旧 Flash 别名已路由到新版；deepseek-v4-pro 计划于 9 月 14 日 04:00 UTC 切换。直接调用 DeepSeek 官方 API 独立计费。

准备隔离环境

执行 python3 -m venv .venv，激活后安装 openai 包，并记录 python -m pip show openai 的版本信息。在环境变量中设置 DEEPSEEK_API_KEY，不要写入代码或提交 Git。账号需具备所选模型的访问能力；这与下方无需密钥的本地练习不同。

发起一次文本请求

保存为 deepseek_smoke.py，执行 python deepseek_smoke.py：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
    timeout=30.0,
    max_retries=0,
)
result = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Reply with one sentence about unit tests."}],
    stream=False,
)
print(result.choices[0].message.content)
print(result.usage)

成功时应打印回复及用量信息。回复内容可能变化，应确认两者存在后再扩大测试。代码设置 30 秒超时并关闭自动重试，以保留首次失败。实际 SDK 版本和线上响应请写进自己的记录。

Responses 只兼容部分功能

官方指南支持 Responses，但将 file_search 列为忽略项；previous_response_id 和 background 不受支持。旧文的内置文件搜索示例与完整替换暗示已删除。仓库搜索应使用经过测试的自定义函数工具，并在所选运行环境中执行。

失败时怎么处理

• 找不到环境变量：在当前终端设置密钥，不要贴进脚本。
• 鉴权或访问被拒：核对提供方控制台中的账号与模型权限。
• 限额或配额拒绝：保留失败记录，查看限制并为重试设定预算。
• 超时或连接异常：先检查地址与网络，再调整提示词。
• 参数被静默忽略：验证预期动作是否真的发生，不能只看请求成功。

继续阅读当前模型状态，或先完成无需密钥的本地练习。

#model evaluation#AI coding