ホーム › APIの始め方 › 会話履歴の渡し方

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の記載)。

reasoning_contentの扱い
リクエストに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の値が基準です。画像のトークンは、画像のサイズから見積もれます(画像入力のページ)。金額は料金計算ツールに文字数を入れても試せます。

確認した公式資料

上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。サンプルコードは公式の例をもとに、このサイトで読みやすく書き換えたものです。

あわせて読むページ

よくある質問

APIは前の質問を覚えていますか?

覚えていません。/chat/completions APIはステートレスで、サーバーは文脈を記録しません。続きの質問では、履歴を毎回すべて送ります。

思考モードのreasoning_contentは毎回保存して返すべきですか?

リクエストにtoolsを付けない会話では、返さなくて構いません(渡しても無視されます)。toolsを付けた会話では、全ターン分を返す必要があり、返さないと400エラーになります。

会話が長くなると料金はどうなりますか?

毎回の入力が増えるため、累計の入力トークンは回数が増えるほど大きく増えます。同じ冒頭はキャッシュにヒットすると安い単価になります。