ホーム › APIの始め方 › FIM補完とプレフィックス補完
DeepSeekガイド
DeepSeek APIのFIM補完とチャットプレフィックス補完:書き方と使い分け
DeepSeek APIには、通常のチャットとは別に、「中間を埋める」FIM補完と「書き出しの続きを書かせる」チャットプレフィックス補完があります。どちらもBeta機能です。2026年11月11日に確認した公式の条件とコードを、使い分けの目安とともに整理します。
2つの違い
FIM補完は、前の部分(prefix)と後ろの部分(suffix、省略可)を渡すと、その間を埋めます。コードの補完に向きます。チャットプレフィックス補完は、アシスタントの返答の書き出しを指定し、その続きを書かせます。出力の形を強制したいときに向きます。
| 項目 | FIM補完 | チャットプレフィックス補完 |
|---|---|---|
| エンドポイント | /completions | /chat/completions |
| 渡すもの | prompt(前)+suffix(後ろ・省略可) | 最後のメッセージをassistantにしてprefix: true |
| 最大出力 | max_tokensは4Kまで | (記載なし) |
| 思考モード | 非思考モードのみ(料金ページ) | (料金ページでは両モデル対応と表示) |
| base_url | https://api.deepseek.com/beta | https://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つです。
- base_urlをbetaにする。通常のhttps://api.deepseek.comではBetaは有効になりません。
- chat.completionsではなくcompletions.createを使う。返答はmessageではなくtextに入ります。
- 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の原因を切り分けます。
確認した公式資料
- DeepSeek API Docs「FIM Completion (Beta)」
- DeepSeek API Docs「Chat Prefix Completion (Beta)」
- DeepSeek API Docs「Models & Pricing」
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。サンプルコードは公式の例をもとに、このサイトで読みやすく書き換えたものです。
あわせて読むページ
よくある質問
FIM補完とは何ですか?
前の部分と後ろの部分を渡すと、その間を埋めてくれる補完です。コードの補完でよく使われます。DeepSeek APIではBeta機能で、base_urlをhttps://api.deepseek.com/betaにして使います。
FIM補完で長い文章を生成できますか?
公式は、FIM補完のmax_tokensを4Kまでと案内しています。長い文章の生成ではなく、位置を指定した短い補完に向きます。
チャットプレフィックス補完で、余計な説明を止めるには?
書き出しに「```python」のような区切りを指定し、stopに閉じ側の「```」を指定します。公式の例がこの形です。