DeepSeek V4 API 使用指南

1. 注册与认证

DeepSeek V4 API 兼容 OpenAI SDK，这不仅大大降低了迁移成本，也让开发者能无缝接入现有的 AI 生态工具。

获取 API Key

1. 访问 DeepSeek Platform。
2. 点击右上角 "API Keys" -> "Create new secret key"。
3. 注意: Key 仅在创建时显示一次，请妥善保存。

2. 快速开始 (Python 示例)

首先安装 OpenAI 官方 SDK (是的，你没看错，直接用 OpenAI SDK)：

pip install openai

然后，只需修改两个参数：base_url 和 api_key。

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # 你的 DeepSeek API Key
    base_url="https://api.deepseek.com"  # 关键点！
)

response = client.chat.completions.create(
    model="deepseek-v4",  # 模型名称，V4 发布后可能会有所不同
    messages=[
        {"role": "system", "content": "你是一个乐于助人的 AI 助手。"},
        {"role": "user", "content": "你好，请介绍一下 DeepSeek V4。"},
    ],
    stream=False
)

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

3. 高级功能

3.1 流式输出 (Streaming)

为了提升用户体验，建议开启流式输出，让用户看到像打字机一样的生成效果。

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "写一首关于鲸鱼的长诗"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

3.2 函数调用 (Function Calling)

DeepSeek V4 支持强大的 Function Calling，能够精准地解析 JSON 参数，非常适合构建 Agent。

3.3 JSON Mode

若你需要模型一定输出合法的 JSON 格式，请务必在 response_format 中指定 json_object，并在 prompt 中明确要求输出 JSON。

4. 定价与成本优化

DeepSeek V4 的定价极其亲民（具体价格等待官方公布，参考 V3 为 $0.14/M tokens）。 为了进一步省钱：

• Prompt Caching: V4 引入了上下文缓存机制。如果你的 System Prompt 很长（如知识库），由于缓存命中，后续请求的费用会大幅降低。
• 精简 Context: 别把无关的聊天记录都塞进去。

5. 最佳实践

• 错误处理: 请务必做好 try-except，特别是针对 rate_limit_exceeded (429) 错误，实行指数退避重试策略。
• 超时设置: 复杂的推理任务可能需要更长的生成时间，建议将 timeout 设置在 60s 以上。
• System Prompt: 给 V4 一个清晰的"人设"，它会表现得更好。

遇到问题？查看我们的 API 文档 或加入 Discord 社区寻求帮助。