共计 1637 个字符,预计需要花费 5 分钟才能阅读完成。
最近在使用 DeepSeek API 时,遇到了一个常见的错误:400 The supported API model names are deepseek-v4-pro or deepseek。这个错误虽然简单,但对于刚接触 DeepSeek API 的开发者来说可能会有些困惑。今天我们就来详细解析这个错误,并分享如何正确使用模型名称。

错误背景与触发场景
这个错误通常发生在 API 请求中指定的模型名称不正确时。DeepSeek API 目前仅支持两种模型名称:
deepseek-v4-prodeepseek
如果你在请求中使用了其他名称,比如 deepseek-v3 或者拼写错误(如deepseek-pro),就会触发这个 400 错误。
API 请求参数详解
一个标准的 DeepSeek API 请求通常包含以下几个关键参数:
model:指定要使用的模型名称,必须是deepseek-v4-pro或deepseek之一messages:包含对话历史的数组temperature:控制生成文本的随机性max_tokens:限制响应中的最大 token 数
其中,model参数就是我们今天要重点讨论的。
正确使用模型名称的代码示例
Python 示例
import requests
# 正确的 API 请求示例
url = "https://api.deepseek.com/v1/chat/completions"
headers = {
"Authorization": "Bearer your_api_key_here",
"Content-Type": "application/json"
}
data = {
"model": "deepseek-v4-pro", # 或使用 "deepseek"
"messages": [{"role": "user", "content": "解释一下量子计算的基本原理"}
],
"temperature": 0.7,
"max_tokens": 500
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
cURL 示例
curl -X POST "https://api.deepseek.com/v1/chat/completions" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek","messages": [{"role":"user","content":" 写一首关于春天的诗 "}],"temperature": 0.7,"max_tokens": 300
}'
模型区别与选择建议
DeepSeek 提供了两种模型,它们的主要区别如下:
- deepseek-v4-pro
- 更强大的性能
- 处理复杂任务能力更强
- 适合需要高质量输出的专业场景
- 响应时间可能稍长
-
消耗的 token 可能更多
-
deepseek
- 基础版本
- 响应速度更快
- 适合一般性任务
- 资源消耗较少
选择建议:
– 如果是简单的问答、摘要等任务,使用 deepseek 就足够了
– 如果需要处理复杂逻辑、专业内容或需要更高精度的输出,选择deepseek-v4-pro
– 可以先试用两个模型,比较输出质量和响应时间,再决定使用哪个
常见问题排查指南
遇到 400 错误时,可以按照以下步骤检查:
- 确认
model参数拼写完全正确 - 确保没有多余的空格或特殊字符
- 检查 API 端点 URL 是否正确
- 验证 API 密钥是否有效
- 如果问题仍存在,可以尝试简化请求,只保留必要参数
实践练习建议
为了更好地理解模型名称的使用,建议尝试以下练习:
- 用
deepseek和deepseek-v4-pro分别发送相同的请求,比较响应差异 - 故意使用错误的模型名称,观察错误信息
- 尝试在不同的任务类型下测试两个模型的性能差异
通过实际操作,你会更清楚地了解如何选择合适的模型,以及如何避免常见的 API 错误。希望这篇文章能帮助你顺利使用 DeepSeek API!
正文完
发表至: 技术分享
近一天内
