DeepSeek V4 Pro API 怎么用：从首次调用到接入 Claude Code

你将完成什么

1. 第一次成功的 V4 Pro 请求（Anthropic Messages 格式）；
2. 让 Claude Code 通过 EvoLink 跑在 V4 Pro 上；
3. 正确控制 thinking 模式（以及为什么 budget_tokens 悄悄失效）；
4. 避开从 Claude 迁移时最容易踩的三个参数坑；
5. 生产环境的 429/并发策略与回退路由。

准备工作

• EvoLink 账号和 控制台 里创建的 API Key。
• 任意 HTTP 客户端。下方示例用 cURL 和原生 Python（requests），让请求结构一目了然。
• 完整参数合同见 DeepSeek V4 Messages API 文档；本文讲流程和坑，不重复参数手册。

第一步：首次 V4 Pro 请求

curl https://direct.evolink.ai/v1/messages \
  -H "Authorization: Bearer $EVOLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Refactor this function to be iterative: def f(n): return n*f(n-1) if n else 1"}
    ]
  }'

同样的调用用 Python 写，零依赖负担：

import requests, os

resp = requests.post(
    "https://direct.evolink.ai/v1/messages",
    headers={"Authorization": f"Bearer {os.environ['EVOLINK_API_KEY']}"},
    json={
        "model": "deepseek-v4-pro",
        "max_tokens": 1024,
        "messages": [{"role": "user", "content": "用两句话总结 MoE 路由的取舍。"}],
    },
    timeout=120,
)
resp.raise_for_status()
blocks = resp.json()["content"]
print(next(b["text"] for b in blocks if b["type"] == "text"))

第二步：把 Claude Code 切到 DeepSeek V4 Pro

因为 EvoLink 用 Anthropic 兼容的 Messages 端点提供 V4 Pro，Claude Code 只需覆盖端点环境变量就能切换：

export ANTHROPIC_BASE_URL="https://direct.evolink.ai"
export ANTHROPIC_AUTH_TOKEN="your-evolink-api-key"
export ANTHROPIC_MODEL="deepseek-v4-pro"
claude

切换到此为止：你的 agent 工作流、工具、提示词全部不变。社区的一致反馈是 V4 Pro 最强的场景就是长链路、多步骤的编码任务——0813 版在终端 agent 基准上的得分接近翻倍——所以 Claude Code 这类 agent 框架正是它对闭源模型拉开性价比的地方。

这套配置的两个实用注意：

• 工具调用走标准的 Anthropic tool_use / tool_result 流程，Claude Code 的文件编辑和 shell 工具正常工作。
• V4 Pro 没有视觉输入。Claude Code 里涉及截图或图片的功能在这条路由上不可用；这类任务保留一个带视觉能力的模型。

第三步：三个迁移坑

以下是与 Anthropic 原生 API 悄悄不同的参数映射，全部来自当前 EvoLink 合同（2026 年 8 月 13 日核验）。

{
  "thinking": {"type": "enabled"},
  "output_config": {"effort": "high"}
}

{
  "model": "deepseek-v4-pro",
  "system": "You are a terse senior reviewer.",
  "messages": [{"role": "user", "content": "Review this diff..."}]
}

第四步：thinking 档位与你的账单

DeepSeek 把 thinking token 按输出 token 计费，而 V4 Pro 是个"思考大户"：社区实测中它在同一任务上消耗的推理 token 可以是闭源同行的数倍。实用建议：

• 默认档就是 effort: "high"——对日常任务偏重。批量步骤显式设 low，攻坚任务保持 high，max 是升级档。
• 缓存命中输入按未命中价约 1/120 计费的口径有效期到 2026 年 8 月 16 日 16:00 UTC；官方已公布的新价随后生效（峰谷双价，Pro 缓存比约变为 1/30）。系统提示词稳定的长会话 agent 仍然受益。实时单价以 EvoLink 的 DeepSeek 模型价格 为准，不要相信任何博客里写死的数字，包括本文。
• 大批量、低难度的步骤（分类、摘要）路由到 deepseek-v4-flash，把 Pro 留给硬任务。

第五步：并发、429 与回退

1. 把 429 当作背压信号：指数退避加抖动，并把在途请求数压在实测上限之下；
2. high 档任务把客户端超时设宽——先思考后吐字，首 token 前的等待是正常的；
3. 配置回退：EvoLink 路由对多个模型说同一种 Messages 格式，从 deepseek-v4-pro 回退到其他可用模型是一次配置变更而不是重写。社区里全是这个模式——Flash 干批量、Pro 攻坚、闭源模型兜底。

FAQ

下一步

• EvoLink 上的 DeepSeek 模型 —— 实时价格与模型接入。
• DeepSeek V4 Pro 0813 更新了什么 —— GA 版的 agent 与 Codex 变化。
• Pro 与 Flash 选型指南 —— 哪个档位适合哪类工作负载。