ホーム › APIの始め方 › 画像入力とFiles API
DeepSeekガイド
DeepSeek APIの画像入力とFiles API:送り方と上限の一覧
deepseek-flashは、テキストと一緒に画像を読ませられます。スクリーンショットの文字読み取りや、グラフの説明にも使えます。2026年11月11日に確認した公式のVisionとFiles APIのページから、3つの送り方、サイズの上限、トークンの数え方、保存期間をまとめます。
対応するモデルと形式
画像を読ませられるのはdeepseek-flashです。deepseek-v4-proは画像に対応していません(料金ページの表示)。対応する形式はJPEG・PNG・GIF・WebPで、形式はファイル名や宣言したMIMEタイプではなく、ファイルの中身から判定されます。
旧名のdeepseek-v4-flash-vision-expも受け付けられますが、そのモデルは廃止され、最新のFlashモデルが処理します。新しく作るコードでは、deepseek-flashを使います。
画像を送る3つの方法
| 方法 | 書き方 | 上限・条件 | 向く場面 |
|---|---|---|---|
| base64(インライン) | data:image/jpeg;base64,… をimage_urlに入れる | リクエスト本文は48MiBまで。1枚32MiBまで | 手元のファイルを1回だけ送る |
| 外部URL | 公開されたhttp(s)のURLを入れる | URLは8,192文字まで。画像32MiBまで。ダウンロードは60秒以内 | すでにWebに置いてある画像 |
| Files APIのfile_id | 先にアップロードし、file_idで参照する | 1枚64MiBまで。32MiBの検査の対象外 | 同じ画像を何度も使う、大きい画像 |
3つとも、OpenAI互換のChat Completionsの形で送ります。contentを文字列ではなく、ブロックの配列にするのが特徴です。
import base64
from openai import OpenAI
client = OpenAI(api_key="<APIキー>", base_url="https://api.deepseek.com")
with open("screenshot.png", "rb") as f:
b64 = base64.b64encode(f.read()).decode("utf-8")
res = client.chat.completions.create(
model="deepseek-flash",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "この画面に書かれている文字を読み取ってください。"},
{"type": "image_url",
"image_url": {"url": f"data:image/png;base64,{b64}", "detail": "low"}},
],
}],
)
print(res.choices[0].message.content)detailは省略できます。lowにすると画像が512×512に縮小されてから処理され、細部が要らない場合に速く安くなります。high・original・autoは、現時点ではいずれも元の大きさで処理されると公式に書かれています。
画像のトークンは1枚あたり最大1,024
画像は、処理の前に自動で大きさが調整されます。
- 全体で約544×544ピクセルに満たない画像は、縦横比を保ったまま拡大されます。
- それより大きい画像は、縦横比を保ったまま、全体が約1300×1300ピクセル相当になるよう縮小されます。
この結果、1枚あたりのトークンには1,024という上限があります。公式の例では、2000×2000ピクセルと5000×5000ピクセルの画像は、縮小後に同じトークン数になります。複数枚を送る場合も、1枚ずつ同じ規則で数えられ、別の計算はありません。画像のトークンは、テキストのトークンと合わせて請求されます。見積もりには、公式のToken & Token Usageページの画像トークン計算機を使えます。実際の値はAPIが返すusageが基準です。
上限の一覧と、400になる使い方
| 項目 | 値 |
|---|---|
| 対応形式 | JPEG・PNG・GIF・WebP |
| 外部URLの長さ | 8,192文字 |
| リクエスト本文 | 48MiB |
| 1枚の最大サイズ(base64・外部URL) | 32MiB |
| 1枚の最大サイズ(Files APIのfile_id) | 64MiB |
| 1リクエストの画像枚数 | 600枚 |
| 1リクエストの画像の合計 | file_idなしで64MiB/file_idを含めて200MiBまで |
| 画像の1辺 | 8,192ピクセル(15枚以上を送るときは4,096ピクセル) |
画像を置けるのはユーザーのメッセージだけです。systemやassistantのメッセージに画像を入れると400エラーになります。400の読み方はエラーコードの一覧にあります。
Files API:アップロードして使い回す
同じ画像を何度も使うときや、本文の上限を超えるときは、先にFiles APIでアップロードし、返ってきたfile_id(file-api-…の形)で参照します。
with open("image.jpg", "rb") as f:
uploaded = client.files.create(file=f, purpose="user_data")
file_id = uploaded.id # 使うときは {"type": "file", "file_id": file_id}| 項目 | 値 |
|---|---|
| アップロードの目的(purpose) | user_data のみ |
| 1ファイルの最大サイズ | 64MiB(アップロードは10分以内) |
| 保存の期間 | 1時間〜30日を指定。指定しなければ永続 |
| 1ユーザーの保存容量 | 25GiB |
| 保存できるファイル数 | 1万件 |
| ファイル名の長さ | 512バイトまで |
保存期間は、アップロードのフォームの項目 expires_after[anchor](created_at)と expires_after[seconds](3,600〜2,592,000秒)の2つをあわせて指定します。ファイルはアカウントに属し、同じアカウントのすべてのAPIキーから共有されます。保存期間を指定しない場合は、ファイルが残り続けます。個人情報や機密を含む画像は、期間を短く指定するか、使い終わったら削除してください(削除はclient.files.delete)。入力してはいけない情報の考え方は安全に使うための注意点にあります。
確認した公式資料
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。サンプルコードは公式の例をもとに、このサイトで読みやすく書き換えたものです。
あわせて読むページ
よくある質問
deepseek-v4-proで画像は読めますか?
読めません。2026年11月11日の料金ページでは、Visionに対応するのはdeepseek-flashだけと表示されています。
画像を送ると料金はどうなりますか?
画像はサイズからトークンに換算され、テキストのトークンと合わせて請求されます。1枚あたり最大1,024トークンの上限があります。
アップロードした画像はいつ消えますか?
アップロード時に1時間〜30日で保存期間を指定できます。指定しなければ永続です。不要になったら削除できます。