DeepSeek 免费额度怎么领：新开发者 500 万 tokens 申请与 API 接入教程

DeepSeek 的接口兼容 OpenAI 的请求格式，因此既能用 curl 直接请求，也能把 OpenAI 官方 SDK 的 base_url 指过来复用现有代码。

• base_url：直接请求时用 https://api.deepseek.com；走 OpenAI SDK 时通常写 https://api.deepseek.com/v1。
• 常用模型名：deepseek-chat 是通用对话模型，deepseek-reasoner 是推理模型；完整模型列表与当前单价以控制台「模型与价格」页面显示为准。

先把密钥写进环境变量，避免把明文密钥提交到代码仓库：

export DEEPSEEK_API_KEY="sk-替换为你在控制台创建的密钥"

再用 curl 发起一次对话补全请求，快速验证密钥、网络与额度是否正常：

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "你是一个简洁的中文助手"},
      {"role": "user", "content": "用一句话解释什么是 API"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

在 Python 项目里可以直接复用 OpenAI SDK，只改 base_url 与模型名即可：

from openai import OpenAI

client = OpenAI(
    api_key="sk-替换为你在控制台创建的密钥",
    base_url="https://api.deepseek.com"
)

resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
    temperature=0.7,
    max_tokens=512
)
print(resp.choices[0].message.content)

调用中的关键参数含义如下：

• model：必填，指定要调用的模型名，写错会直接返回参数错误。
• messages：必填，消息数组，每条包含 role（system、user、assistant）与 content，多轮对话要把历史消息按顺序带上。
• temperature：可选，控制输出随机性，取值越低越稳定，做结构化输出时建议调小。
• max_tokens：可选，限制本次回复生成的最大 token 数，设得过小会导致回答被截断。
• stream：可选，设为 true 时按数据流逐段返回，适合网页打字机效果；配合 stream_options 里的 include_usage 可拿到本次调用的 token 用量。

额度耗尽或触发限流时，接口会返回明确的错误码：密钥缺失或无效通常是 401，余额不足通常是 402，请求过快或并发超限通常是 429，参数或模型名错误是 400。建议按以下顺序排查：

1. 先确认请求头里的密钥是否完整、是否已被删除或复制时带了多余空格。
2. 再核对 base_url 与模型名拼写，注意不要把网页对话版地址当成接口地址。
3. 到控制台查看赠额余额与到期时间，判断是已耗尽还是已过期。
4. 若返回 429，降低并发与请求频率，加入指数退避重试。
5. 最后检查 max_tokens 设置与上下文长度是否超出模型上限。