DeepSeekガイド
DeepSeek APIの会話履歴の渡し方:覚えてくれない前提で組む
DeepSeekの/chat/completions APIは「ステートレス」で、サーバーは会話の文脈を記録しません。続きの質問をするには、これまでの履歴を毎回すべて自分で送ります。2026年11月11日に確認した公式の説明をもとに、書き方、思考モードでの決まり、送る量が増える影響を整理します。
履歴は毎回、全部自分で送る
公式のMulti-round Conversationのページは、/chat/completions APIを「ステートレス」と説明しています。2回目以降の質問では、1回目の質問とモデルの返答を messages に足して、まとめて送ります。
公式の例を日本語に置き換えると、1回目に送るmessagesは次の形です。
[{"role": "user", "content": "世界で一番高い山は?"}]2回目は、1回目の返答と新しい質問を末尾に足します。
[
{"role": "user", "content": "世界で一番高い山は?"},
{"role": "assistant", "content": "世界で一番高い山はエベレストです。"},
{"role": "user", "content": "2番目は?"}
]「2番目は?」だけを送っても、モデルには何の2番目か分かりません。ChatGPTやDeepSeekのWeb画面が会話を覚えているように見えるのは、画面側のアプリが履歴を保存して送り直しているからです。APIを自分のアプリに組み込むときは、この役割を自分のコードが担います。
最小のコード
from openai import OpenAI
client = OpenAI(api_key="<APIキー>", base_url="https://api.deepseek.com")
messages = [{"role": "user", "content": "世界で一番高い山は?"}]
res = client.chat.completions.create(model="deepseek-flash", messages=messages)
messages.append(res.choices[0].message) # 返答を履歴に足す
messages.append({"role": "user", "content": "2番目は?"})
res = client.chat.completions.create(model="deepseek-flash", messages=messages)
print(res.choices[0].message.content)返答(message)をそのまま履歴に足すのが公式の書き方です。アプリで会話を保存するときは、roleとcontentの組を並べて保存しておけば、同じ形で復元できます。
思考モードでは、reasoning_contentを返すかどうかが分かれる
思考モードをオンにすると、各ターンで「思考の文章(reasoning_content)」と「最終回答(content)」が返ります。次のターンでreasoning_contentをAPIに返すべきかどうかは、リクエストにtoolsを付けるかどうかで決まります(公式のThinking Modeの記載)。
| リクエストにtools | 過去のreasoning_content | 備考 |
|---|---|---|
| なし(ふつうの会話) | 返さなくてよい。渡しても無視され、文脈に連結されない | 履歴にはroleとcontentだけで足りる |
| あり(ツール呼び出し) | すべてのターン分を返す。返さないと400エラー | ツール呼び出しのページを参照 |
ふつうの会話では、思考の文章を保存し続ける必要はありません。保存しなければ、自分のデータベースの容量も節約できます。一方、ツールを使う会話では、messageをそのまま履歴に足す書き方にしておくのが安全です。
# ストリーミング時は、断片を足し合わせてから履歴に入れる
messages.append({
"role": "assistant",
"reasoning_content": reasoning_content,
"content": content,
})
履歴が増えると、何が起きるか
履歴を毎回全部送るため、会話が長くなるほど1回あたりの入力トークンが増えます。公式の目安は「英語1文字が約0.3トークン、中国語1文字が約0.6トークン」で、日本語の換算は示されていません。実際の数は、レスポンスのusageが基準です。
仮に、1往復で履歴が1,000トークンずつ増えるとします(これはこのサイトの仮定です)。
| 回 | その回に送る入力 | 累計の入力 |
|---|---|---|
| 1回目 | 約1,000 | 約1,000 |
| 5回目 | 約5,000 | 約15,000 |
| 10回目 | 約10,000 | 約55,000 |
| 20回目 | 約20,000 | 約210,000 |
往復の回数に対して、累計はほぼ二乗で増えます。対策は2つあります。
- キャッシュを効かせる。履歴は前回の続きの形なので、冒頭が一致してキャッシュにヒットしやすく、ヒット分は安い単価です。詳しくはコンテキストキャッシュで説明しています。
- 古い部分を要約して置き換える。一定回数を超えたら、前半を短い要約にして履歴を詰めます。ただし冒頭を書き換えるとキャッシュは外れるため、頻繁には行いません。
送る前にトークン数を数える
公式のToken & Token Usageのページには、トークン数をオフラインで数えるためのデモ用トークナイザー(zip)が案内されています。本番の請求は、APIが返すusageの値が基準です。画像のトークンは、画像のサイズから見積もれます(画像入力のページ)。金額は料金計算ツールに文字数を入れても試せます。
確認した公式資料
- DeepSeek API Docs「Multi-round Conversation」
- DeepSeek API Docs「Thinking Mode」
- DeepSeek API Docs「Token & Token Usage」
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。サンプルコードは公式の例をもとに、このサイトで読みやすく書き換えたものです。
あわせて読むページ
よくある質問
APIは前の質問を覚えていますか?
覚えていません。/chat/completions APIはステートレスで、サーバーは文脈を記録しません。続きの質問では、履歴を毎回すべて送ります。
思考モードのreasoning_contentは毎回保存して返すべきですか?
リクエストにtoolsを付けない会話では、返さなくて構いません(渡しても無視されます)。toolsを付けた会話では、全ターン分を返す必要があり、返さないと400エラーになります。
会話が長くなると料金はどうなりますか?
毎回の入力が増えるため、累計の入力トークンは回数が増えるほど大きく増えます。同じ冒頭はキャッシュにヒットすると安い単価になります。