ホーム › APIの始め方 › FIM補完とプレフィックス補完

DeepSeekガイド

DeepSeek APIのFIM補完とチャットプレフィックス補完:書き方と使い分け

DeepSeek APIには、通常のチャットとは別に、「中間を埋める」FIM補完と「書き出しの続きを書かせる」チャットプレフィックス補完があります。どちらもBeta機能です。2026年11月11日に確認した公式の条件とコードを、使い分けの目安とともに整理します。

確認・更新 

2つの違い

FIM補完は、前の部分(prefix)と後ろの部分(suffix、省略可)を渡すと、その間を埋めます。コードの補完に向きます。チャットプレフィックス補完は、アシスタントの返答の書き出しを指定し、その続きを書かせます。出力の形を強制したいときに向きます。

FIM補完とチャットプレフィックス補完
項目FIM補完チャットプレフィックス補完
エンドポイント/completions/chat/completions
渡すものprompt(前)+suffix(後ろ・省略可)最後のメッセージをassistantにしてprefix: true
最大出力max_tokensは4Kまで(記載なし)
思考モード非思考モードのみ(料金ページ)(料金ページでは両モデル対応と表示)
base_urlhttps://api.deepseek.com/betahttps://api.deepseek.com/beta

FIM補完の書き方

公式の例は、フィボナッチ数を求める関数の「書き出し」と「最後の行」を渡し、中身を補わせるものです。

from openai import OpenAI

client = OpenAI(api_key="<APIキー>", base_url="https://api.deepseek.com/beta")

response = client.completions.create(
    model="deepseek-flash",
    prompt="def fib(a):",
    suffix="    return fib(a-1) + fib(a-2)",
    max_tokens=128,
)
print(response.choices[0].text)

注意点は3つです。

  1. base_urlをbetaにする。通常のhttps://api.deepseek.comではBetaは有効になりません。
  2. chat.completionsではなくcompletions.createを使う。返答はmessageではなくtextに入ります。
  3. max_tokensは4Kまで。長い関数を丸ごと生成する用途ではなく、カーソル位置の数行を埋める用途です。

公式は、VSCodeの補完プラグインContinueとの連携も案内しています。エディタの中で、入力途中の位置の前後を自動でprefixとsuffixにして送る使い方が代表例です。

チャットプレフィックス補完の書き方

条件は2つです。messagesの最後のメッセージのroleをassistantにして、そのメッセージにprefix: trueを付けること、そしてbase_urlをbetaにすることです。公式の例は、書き出しに「```python」を指定してPythonのコードを強制し、stopに「```」を指定して余計な説明を止めます。

client = OpenAI(api_key="<APIキー>", base_url="https://api.deepseek.com/beta")

messages = [
    {"role": "user", "content": "クイックソートのコードを書いてください"},
    {"role": "assistant", "content": "```python\n", "prefix": True},
]
response = client.chat.completions.create(
    model="deepseek-flash",
    messages=messages,
    stop=["```"],
)
print(response.choices[0].message.content)

書き出しとstopの組み合わせで、「コードだけ」「表の1行だけ」のように返答の枠を決められます。返ってくるのは続きの部分だけなので、書き出しに指定した文字は、使う側で足してからファイルに保存します。

どちらを使うか:選び方の目安

用途別の選び方
やりたいこと向く方法理由
エディタで入力途中の数行を埋めるFIM補完前後の文脈を渡せる
返答をコードブロックの中身だけにしたいチャットプレフィックス補完書き出しとstopで枠を決められる
返答をJSONにしたいJSON出力有効なJSONの文字列を保証する仕組み
キーと型まで固定したいstrictのツール呼び出しJSON Schemaに従わせる

Betaは、機能や挙動が変わる可能性がある段階です。公式の更新履歴では、FIM補完とチャットプレフィックス補完は2024年7月25日に追加されて以来、2026年11月11日の時点でもBetaと表記されています。業務で使うときは、モデルを替えたときにも動くかをその都度確かめてください。

よくある詰まりどころ

  • FIMは思考モードでは使えない:料金ページはFIM補完を「非思考モードのみ」と表示しています。思考をオフにして使います(thinkingパラメータはモデルの選び方)。
  • Betaのbase_urlを付け忘れる:通常のbase_urlで試すと、期待どおりに動かない原因になります。
  • プレフィックスの文字を二重に書く:返答には続きだけが入るため、保存時に書き出しを足します。

エラーが出た場合は、APIエラーコードの一覧で400・422の原因を切り分けます。

確認した公式資料

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

あわせて読むページ

よくある質問

FIM補完とは何ですか?

前の部分と後ろの部分を渡すと、その間を埋めてくれる補完です。コードの補完でよく使われます。DeepSeek APIではBeta機能で、base_urlをhttps://api.deepseek.com/betaにして使います。

FIM補完で長い文章を生成できますか?

公式は、FIM補完のmax_tokensを4Kまでと案内しています。長い文章の生成ではなく、位置を指定した短い補完に向きます。

チャットプレフィックス補完で、余計な説明を止めるには?

書き出しに「```python」のような区切りを指定し、stopに閉じ側の「```」を指定します。公式の例がこの形です。