DeepSeek API调用手册
读取当前可用模型列表
查询模型 ID 和能力元数据，在生成请求前确认配置。
← 返回平台功能接入准备
- 准备同一个官方平台 API Key。
准备环境变量
示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行；密钥不应放进公开网页。
DEEPSEEK_API_KEY- 在 DeepSeek API keys 创建，只在本地终端或服务端设置。
export DEEPSEEK_API_KEY='replace_with_your_deepseek_key'以上 export 适用于 macOS / Linux 的终端。按调用步骤保存代码文件，再在同一终端执行。
调用步骤
- 01
设置 DEEPSEEK_API_KEY 后运行 GET /models。
- 02
读取 data[].id，可选能力元数据按实际响应解析。
调用 01
获取模型列表
读取模型配置，不提交生成任务。
GET
https://api.deepseek.com/models请求头
AuthorizationBearer ${DEEPSEEK_API_KEY}
参数说明
本接口无额外业务参数；按上方要求提供凭证。
调用代码
替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误，业务状态还需按下方返回示例核对。
# 执行后核对返回 JSON 的业务状态；HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
--request GET \
--url "https://api.deepseek.com/models" \
--header "Authorization: Bearer ${DEEPSEEK_API_KEY}"
import json
import os
import re
import urllib.request
import urllib.error
def expand(value):
return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
lambda match: os.environ[match.group(1)], value)
url = expand("https://api.deepseek.com/models")
headers = {
"Authorization": expand("Bearer ${DEEPSEEK_API_KEY}"),
}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method="GET")
try:
with urllib.request.urlopen(request, timeout=30) as response:
result = json.load(response)
except urllib.error.HTTPError as error:
print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
// Node.js 22+，保存为 request.mjs 后运行 node request.mjs
function expand(value) {
return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
return process.env[name];
});
}
const url = expand("https://api.deepseek.com/models");
const headers = Object.fromEntries(
Object.entries({
"Authorization": "Bearer ${DEEPSEEK_API_KEY}"
}).map(([key, value]) => [key, expand(value)])
);
const response = await fetch(url, {
method: "GET",
headers,
signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));
返回示例
虚构结构示意，只展示必要字段，非完整模型清单或实测结果。 以下为结构示意，非本站实测结果。
{
"object": "list",
"data": [
{
"id": "deepseek-flash",
"object": "model",
"owned_by": "deepseek"
}
]
}常见错误与排查
HTTP 401Key 无法认证。- 核对 DeepSeek Key 是否有效且未撤销。
HTTP 429账号触发限流。- 降低并发并退避，不用更多 Key 规避账号限额。
调用注意
- 模型列表会变化，不代表已验证列表中每个模型的所有功能。
注意事项
- 模型发现与推理生成是不同接口，不能据此推断账号余额或生成费用。
核验来源
本站按官方资料整理本场景的必要调用步骤与代码，覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。
- 01创建 Key 与根地址核验日期 2026-10-15
- 02错误码核验日期 2026-10-15
- 03List Models核验日期 2026-10-15