DeepSeek API Key 完全指南（2026）：开通、定价与使用

DeepSeek API 概览

可用模型 —— 我们的发现

• deepseek-v4-flash（DeepSeek-V4-Flash-0731）—— 高吞吐 V4 模型。1M 上下文、最大 384K 输出，支持思考与非思考，兼容 OpenAI 与 Anthropic API。成本和并发的默认首选（并发限制 2500）。
• deepseek-v4-pro（DeepSeek-V4-Pro-0813）—— 更高能力的 V4 档，token 单价约为 Flash 的 3 倍。同样是 1M 上下文和 384K 输出，并发限制 500。
• 旧代码示例里仍可能出现 deepseek-chat / deepseek-reasoner 等别名。投产前请以官方文档和控制台中的当前 ID 为准。

获取 API Key

定价结构 —— 成本优势

• deepseek-v4-flash：缓存命中 空闲 ¥0.05 / 高峰 ¥0.10 · 缓存未命中 空闲 ¥1.5 / 高峰 ¥3.0 · 输出 空闲 ¥4.5 / 高峰 ¥9.0
• deepseek-v4-pro：缓存命中 空闲 ¥0.15 / 高峰 ¥0.30 · 缓存未命中 空闲 ¥4.5 / 高峰 ¥9.0 · 输出 空闲 ¥13.5 / 高峰 ¥27.0
• 扣费公式：token 消耗量 × 对应单价；赠送余额优先于充值余额扣减
• 提示缓存仍然关键：缓存命中输入远低于缓存未命中，应保持可复用前缀稳定
• 空闲折扣：把批处理排到北京时间 9:00–12:00、14:00–18:00 之外，可按高峰价一半计费

快速开始：从 OpenAI 迁移

from openai import OpenAI

# Before (OpenAI):
# client = OpenAI(api_key="sk-...", base_url="https://api.openai.com/v1")

# After (DeepSeek) — only 2 lines change:
client = OpenAI(
    api_key="your-deepseek-key",
    base_url="https://api.deepseek.com"  # Official OpenAI-compatible base URL
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",  # or "deepseek-v4-pro"
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

OpenAI SDK 兼容性 —— 完整说明

• 函数调用：支持但行为略有不同 —— 务必仔细测试你的工具使用提示
• JSON 模式：支持，但复杂嵌套 schema 下我们发现不如 OpenAI 可靠
• 视觉：不支持（截至 2026 年 7 月仅为文本模型）
• 流式：完全兼容 —— SSE 格式完全一致
• 向量嵌入：通过单独端点提供，不属于聊天 API

常见坑和建议

• 推理模型延迟 —— 思考模式（默认开启）解决复杂问题会更慢，因为它做思维链推理。实时聊天若不需要思考，应关闭思考；把思考留给批量或高难度路径。
• 中文优化 —— DeepSeek 在中文数据上训练充分。中文任务表现优秀，但英文偶尔不如 GPT-4 自然。
• 支付方式 —— 国际信用卡可用，但有用户反馈偶尔有问题。支付宝/微信支付最可靠。不支持 PayPal。
• 速率限制 —— 默认限制较宽松但文档不清晰。我们在 10 分钟 1000 次请求后被临时封了。建议加指数退避重试逻辑。
• API 稳定性 —— DeepSeek 偶尔有短暂中断（分钟级，非小时级）。生产环境建议实现到其他供应商的降级方案。