【2026年最新】DeepSeek V4 APIを低コストで試す方法 — 登録からPython実装まで

【2026年最新】DeepSeek V4 APIを低コストで試す方法 — 登録からPython実装まで

DeepSeek V4 APIは、OpenAI互換のChat Completions形式でPythonから呼び出せます。本記事ではCometAPIを利用し、APIキーを環境変数に保存して、deepseek-v4-proへ安全にリクエストするところまで実装します。永続的な無料枠は前提にせず、少額のテスト実行として進めます。

はじめに

DeepSeekは2026年4月24日にDeepSeek V4 Previewを公開し、API向けに次の2モデルを提供しています。

今回は、複雑な推論やコーディング向けのdeepseek-v4-proを使います。高速・低コストな処理を優先する場合は、同じコードでモデルIDをdeepseek-v4-flashに変更できます。

料金について: アカウント作成とAPI利用料金は別です。恒久的な無料API枠は確認できないため、「無料で使える」とは断定しません。実行前に必ずモデル一覧と残高を確認してください。

環境

• OS: macOS 15 / Ubuntu 24.04
• Python: 3.12
• ライブラリ: openai 1.x系
• API: CometAPI OpenAI互換エンドポイント
• モデルID: deepseek-v4-pro

1. CometAPIでAPIキーを取得する

1. CometAPIでアカウントを作成します。
2. ダッシュボードからAPIキーを発行します。
3. 利用するモデルの現在の料金と利用可否をモデル一覧で確認します。

APIキーをソースコードへ直接書かず、環境変数に保存します。

macOS / Linuxの場合:

export COMETAPI_KEY="your_api_key_here"
export DEEPSEEK_MODEL_ID="deepseek-v4-pro"

.envを使う場合も、そのファイルを.gitignoreへ追加してください。

2. OpenAI SDKをインストールする

仮想環境を作成してからSDKをインストールします。

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade openai

バージョンを確認します。

python -c "import openai; print(openai.__version__)"

3. DeepSeek V4 Proを呼び出す

deepseek_v4_quickstart.pyを作成します。

import os
import time

from openai import OpenAI


api_key = os.environ.get("COMETAPI_KEY")
model_id = os.environ.get("DEEPSEEK_MODEL_ID", "deepseek-v4-pro")

if not api_key:
    raise RuntimeError("COMETAPI_KEYを環境変数に設定してください。")

client = OpenAI(
    api_key=api_key,
    base_url="https://api.cometapi.com/v1",
    timeout=60.0,
    max_retries=2,
)

started = time.perf_counter()

response = client.chat.completions.create(
    model=model_id,
    messages=[
        {
            "role": "system",
            "content": "あなたは簡潔に回答するシニアPythonエンジニアです。",
        },
        {
            "role": "user",
            "content": (
                "次の関数の問題点を説明し、安全な実装へ修正してください。\n\n"
                "def add_item(item, items=[]):\n"
                "    items.append(item)\n"
                "    return items"
            ),
        },
    ],
    temperature=0.2,
    max_completion_tokens=800,
)

elapsed = time.perf_counter() - started
message = response.choices[0].message.content or ""

print(message)
print(f"\nmodel: {response.model}")
print(f"elapsed: {elapsed:.2f} sec")

if response.usage:
    print(f"input tokens: {response.usage.prompt_tokens}")
    print(f"output tokens: {response.usage.completion_tokens}")

実行します。

python deepseek_v4_quickstart.py

実行に成功すると、修正案の本文に続いて、実際に使われたモデル、処理時間、入出力トークン数が表示されます。回答内容やトークン数は実行時のモデル状態と入力によって変わります。

4. V4 Flashへ切り替える

コードは変更せず、環境変数だけを変更します。

export DEEPSEEK_MODEL_ID="deepseek-v4-flash"
python deepseek_v4_quickstart.py

モデル切り替えを環境変数にすると、ソースコードへモデルIDが散らばりません。本番環境では、利用を承認したモデルIDを設定ファイルで管理すると安全です。

5. リクエスト料金を概算する

2026年7月23日時点のCometAPIモデル一覧では、DeepSeek V4 Proのルート料金は次のとおりです。

たとえば入力1,000 tokens、出力500 tokensの場合、概算は次のようになります。

入力: 1,000 × 0.52 / 1,000,000 = $0.00052
出力:   500 × 1.04 / 1,000,000 = $0.00052
合計:                              $0.00104

これはトークン料金だけの概算です。実際の請求では、最新のルート料金、キャッシュ、リトライ、追加のツール呼び出しなどを確認してください。DeepSeek公式APIとCometAPIでは価格体系が異なるため、混同しないようにします。

6. よくあるエラー

401 Unauthorized

同じターミナルで環境変数が設定されているか確認します。

test -n "$COMETAPI_KEY" && echo "key is set"

キーそのものを画面やログへ表示しないでください。

404 または model not found

• base_urlに/v1が含まれているか確認します。
• モデル一覧で現在の正確なモデルIDを確認します。
• deepseek-chatやdeepseek-reasonerのような旧エイリアスを使っていないか確認します。

DeepSeek公式ドキュメントでは、旧エイリアスは2026年7月24日15:59 UTCに廃止予定です。公開予定日の7月27日には、deepseek-v4-proまたはdeepseek-v4-flashを明示的に指定してください。

429 Too Many Requests

並列数を下げ、指数バックオフとランダムな待ち時間を使って再試行します。同じリクエストを無制限に再試行しないでください。

本番導入前に確認すること

• 30〜100件の実データに近い評価セットを作る
• JSONやツール呼び出しをローカルで検証する
• P50とP95のレイテンシを測る
• リトライを含む「成功1件あたりのコスト」を計算する
• タイムアウト、ログのマスキング、フォールバックを設定する
• モデルIDと料金をリリース時に再確認する

まとめ

• DeepSeek V4 Proはdeepseek-v4-proで呼び出せます。
• CometAPIではOpenAI SDKの接続先を変更して利用できます。
• APIキーは環境変数に保存し、リポジトリへ含めません。
• V4 Flashへの切り替えはモデルIDの変更だけで試せます。
• 「無料」という表現ではなく、実行前に最新料金を確認することが重要です。