ホーム › 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つの方法

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になる使い方

画像まわりの上限(公式のVisionページ)
項目値
対応形式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}
Files APIの上限と保存期間
項目値
アップロードの目的(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日で保存期間を指定できます。指定しなければ永続です。不要になったら削除できます。