DeepSeek V4.1 Flash APIの使い方：モデルIDとPython・curlの設定

公式DeepSeek V4.1 Flash APIを直接呼び出す場合は、model="deepseek-flash" とベースURL https://api.deepseek.com を使います。 公開されている製品名とリクエストの識別子は別の文字列です。第三者ゲートウェイには独自のモデル識別子や認証情報がある場合があります。

以下の例は公式クイックスタートと2026年9月10日の変更履歴に基づきます。ドキュメントと照合した設定例であり、有料のエンドツーエンドテストではありません。生成リクエストの実行ではクレジットを消費する場合があります。

最初にアカウントとモデルを確認する

実際に呼び出すプロバイダーから認証情報を取得してください。公式DeepSeekのキーはDeepSeekのエンドポイントと、OfoxのキーはOfoxが案内する経路と組み合わせます。別プロバイダーのキーとエンドポイントを混在させないでください。

以下の例では、ローカル環境の DEEPSEEK_API_KEY に認証情報を設定します。コミットやログへの出力は避けてください。モデルの実体が変わっても旧V4 Flash名が受け付けられる理由は、deepseek-flashの公開情報で説明しています。

Pythonで短いテキスト応答を取得する

プロジェクトの環境で python -m pip install openai を実行して公式OpenAI Pythonパッケージをインストールし、互換クライアントを使います。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)
response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Reply with one short greeting."}],
    max_tokens=128,
    extra_body={"thinking": {"type": "disabled"}},
)
print(response.choices[0].message.content)
print(response.usage)

最初の診断リクエストを小さくするため、思考モードとツールは使っていません。推論エージェントの費用や挙動を示す例ではありません。基本の呼び出しが動いたら、必要な機能を一つずつ追加し、各機能のパラメーターを公式文書で確認してください。

curlで送信内容を比較する

curl --fail-with-body https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with one short greeting."}],"max_tokens":128,"thinking":{"type":"disabled"}}'

JSON本文は同じ短いテキスト処理を指定しています。失敗した場合は、機密情報を除いてエラー本文を保存してください。ステータス番号だけでは、経路やアカウントの間違いが分からない場合があります。Authorizationヘッダーを含む詳細ログをサポート窓口に貼り付けないでください。

JavaScriptでは、OpenAI SDKの baseURL オプションと、同じモデル名・JSONフィールドを使います。Pythonの引数名をそのまま置き換えず、インストールしたSDKの仕様に従ってください。

クライアントに合うプロトコルを選ぶ

クライアントごとの設定はCodexガイドまたはClaude Codeガイドを参照してください。テキスト応答に成功しても、ツールを繰り返し呼び出す処理、画像入力、ストリーミング解析まで確認できたことにはなりません。

モデルが見つからない・リクエストが失敗する場合

まず接続先、その次に正確な識別子を確認します。古いクライアントのカタログに deepseek-flash がない場合や、ゲートウェイが別名を使っている場合があります。expires-on-0910 のテスト用設定を正式版の仕様として扱わないでください。不明なモデルに対して全サービスが同じエラーコードを返すとは限らないため、実際の応答を記録します。

DeepSeekのエラーコード一覧では、401は認証、402は残高不足、400はリクエスト形式、422はパラメーター、429はレート制限と区別されています。入金が関係するのは残高不足が確認された場合であり、不正な本文や未対応モデル名を直すことはできません。一時的な失敗には間隔を空けて再試行し、無制限に続けないでください。

バッチ処理の予算を入金する前に料金計算ガイドを確認しましょう。Ofoxを選ぶ場合はモデル一覧と認証ガイドで経路・課金条件を確認したうえで登録してください。この直接接続の例は、ゲートウェイでも同じ設定が使えるという主張ではありません。

購入先を決める前に、API 購入前のチェックリストでモデル、プロトコル、課金条件を確認してください。