EvoLink での DeepSeek V4 Pro API の使い方：初回リクエストから Claude Code 連携まで

この記事でできるようになること

1. Anthropic Messages 形式での最初の V4 Pro リクエスト成功；
2. EvoLink 経由で V4 Pro 上で動く Claude Code のセットアップ；
3. thinking モードの正しい制御（および budget_tokens が静かに無効になる理由）；
4. Claude からの移行を壊す 3 つのパラメータマッピングへの対処；
5. 本番向けの 429／同時実行数の戦略とフォールバックルート。

前提条件

• EvoLink アカウントと、ダッシュボードで発行した API キー。
• 任意の HTTP クライアント。以下の例はリクエストの構造が明示的になるよう、cURL と素の Python（requests）を使います。
• パラメータの完全な仕様は DeepSeek V4 Messages API ドキュメントにあります。本記事はフローと落とし穴に絞り、リファレンスの複製はしません。

ステップ 1 — 最初の 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": "Summarize the tradeoffs of MoE routing in two sentences."}],
    },
    timeout=120,
)
resp.raise_for_status()
blocks = resp.json()["content"]
print(next(b["text"] for b in blocks if b["type"] == "text"))

ステップ 2 — Claude Code を DeepSeek V4 Pro に切り替える

EvoLink は V4 Pro を Anthropic 互換の Messages エンドポイントで提供しているため、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

切り替えはこれで完了です。エージェントのワークフロー、ツール、プロンプトはそのまま使えます。コミュニティの報告では、V4 Pro が最も強いのは長い多段ステップのコーディングタスクだという評価で一貫しています — 0813 ビルドはターミナルエージェント系ベンチマークでスコアをほぼ倍増させました — つまり Claude Code のようなエージェントハーネスこそ、クローズドモデルに対する価格差が最も効く場所です。

このセットアップでの実用上の注意が 2 点あります：

• ツール呼び出しは標準の Anthropic tool_use / tool_result フローで動作するため、Claude Code のファイル編集やシェルツールは通常どおり機能します。
• V4 Pro には画像入力（vision）がありません。スクリーンショットや画像を添付する Claude Code の機能はこのルートでは動作しません。そうしたタスク用には vision 対応モデルを残しておいてください。

ステップ 3 — 移行の 3 つの落とし穴

以下は Anthropic ネイティブ API と静かに挙動が異なるマッピングです。3 つとも現行の 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..."}]
}

ステップ 4 — thinking effort と請求額への影響

DeepSeek は thinking トークンを出力トークンとして課金します。そして V4 Pro はかなりの「考え込み屋」です：コミュニティの計測では、同一タスクでクローズドモデル勢の数倍の推論トークンを消費した例が報告されています。実務上のガイドライン：

• デフォルトは effort: "high" — 日常的なタスクには重めの設定です。バルクステップでは明示的に low を指定し、「タスク失敗のコストが追加トークン代を上回る」場合に high を維持、max はエスカレーション用の段階として使います。
• キャッシュヒットした入力がキャッシュミス時のおよそ 1/120 の料金で課金されるのは 2026 年 8 月 16 日 16:00 UTC までです。以降は DeepSeek が公表済みの新料金が適用されます（ピーク／オフピークの二重料金制で、Pro のキャッシュ比率はおよそ 1/30 に）。システムプロンプトが安定している長時間のエージェントセッションは引き続き恩恵を受けます。トークン単価のライブ情報は EvoLink の DeepSeek モデル料金で確認してください。この記事を含め、ブログにハードコードされた数字を信じてはいけません。
• 大量・低難度のステップ（分類、要約）は deepseek-v4-flash にルーティングし、Pro は難しいステップのために温存してください。

ステップ 5 — 同時実行数、429、フォールバック

1. 429 はバックプレッシャーとして扱う：ジッター付き指数バックオフを使い、同時実行中のリクエスト数を実測した上限より下に抑える。
2. high effort のタスクではクライアントのタイムアウトを長めに設定する — 最初のトークンが出る前に思考時間が挟まります。
3. フォールバックを設定する：EvoLink のルートは複数のモデルに対して同じ Messages 形式で話すため、deepseek-v4-pro から別の利用可能なモデルへのルーター側フォールバックは、書き直しではなく設定変更 1 つで済みます。コミュニティのスレッドはまさにこのパターンで溢れています — バルク処理は Flash、難所は Pro、最終フォールバックにクローズドモデル。

FAQ

次のステップ

• EvoLink 上の DeepSeek モデル — ライブ料金とモデルへのアクセス。
• DeepSeek V4 Pro 0813 の変更点 — GA ビルドのエージェントと Codex まわりの変化。
• Pro vs Flash 選定ガイド — どのティアがどのワークロードに合うか。