DeepSeek API 的图片输入由 deepseek-flash 一个名字承接（官方视觉指南，核对时间 2026 年 11 月 3 日；v4-pro 不支持视觉，模型名与能力对照见DeepSeek 模型名怎么填）。与 Kimi 不支持公网图片 URL 不同，DeepSeek 允许直接给公网 http(s) 链接，模型自己下载——三家之间这条规则不一样，混用时最容易踩。这篇把三种传法、上限数字、token 折算一次讲清。
先记格式与三条硬规矩
支持四种格式：JPEG、PNG、GIF、WebP。格式按文件实际内容检测，不看文件名后缀、也不看声明的 MIME 类型——改个后缀骗不过它，图片真坏了也瞒不住。三条硬规矩：
一是图片只能放在 user 消息里。system 或 assistant 消息里放图片块，官方口径是直接返回 400 报错——多轮对话里别把历史图片塞进 assistant 轮次。二是传法不同，上限不同。内联 base64 计入请求体 48 MiB 上限；公网 URL 单图最大 32 MiB 且必须 60 秒内下载完成；走 Files API 引用 file_id 的单图可到 64 MiB。三是多图有总量闸。单请求最多 600 张图，总大小不带 file_id 上限 64 MiB、含 file_id 可到 200 MiB；单边尺寸 8192 像素封顶（一张请求里有 15 张以上图片时降到 4096 像素）。
三种传法，按场景选
| 传法 | 怎么发 | 适合场景 |
|---|---|---|
| base64 内联 | 图片编码成 data: URL 塞进 image_url 块 | 本地文件、一次性请求，最省事 |
| 公网 URL | 直接给 https 链接（8192 字符内） | 图已在网上；注意 32 MiB 与 60 秒下载限时 |
| Files API file_id | 先上传拿 file-api- 开头的 id，请求里引用 | 同一张图多次复用、或单图超过 32 MiB |
第三种还有个变体：file 块可以不传 file_id 而用 file_data 内联 base64（两者互斥）。选定原则一句话：用一次就 base64，重复用就上传换 id，超 32 MiB 只有 Files API 一条路。另外 OpenAI 风格的 content 必须是「文本块＋图片块」的对象数组，不能像纯文本对话那样直接给字符串——这点与 Kimi 的要求一致，结构见Kimi 图片输入怎么发，两边可以照着改。
detail 参数：一分钱一分货
image_url 块可以带一个 detail 字段控制处理精度：low 会把图缩到 512×512 再推理，更快更省，表格截图读大数字这类任务够用；high、original、auto 目前都等价于保留原图。读小字、看细节再上 original。图片最终会折算成 token 计费，机制与「图片按像素折算」的通用规则一致（折算原理见什么是多模态 token），折算前还有一次自动缩放：小图（总像素低于约 544×544）放大，大图缩到约 1300×1300 的总像素水平——结果是单张图片的 token 上限约 1024，2000×2000 和 5000×5000 的图折算后一样多，为省账单而刻意压分辨率，超出这个水平后没有意义。
三种接入格式的写法差异
同一张图，三种 API 风格的块结构不同：OpenAI 兼容格式用 image_url 块（data URL 或公网链接）；Anthropic 兼容格式（base_url 带 /anthropic）用 image 块加 source 对象，source 的 type 分 base64（要带 media_type）、url、file 三种，其中 file 引用要加 anthropic-beta 请求头；Responses API 用 input_image 块，detail 语义相同，file_id 与 image_url 互斥。走哪个格式就用哪个块结构，混着抄会 400。
报错对号：三处最容易中
图片相关的报错集中在三处（完整错误码对照见DeepSeek API 报错对照）：一是图片放错消息角色（system/assistant）直接 400；二是公网 URL 下载超时或目标站拒绝访问——换 base64 或 Files API 绕开下载环节；三是请求体超 48 MiB（多张大图内联）——把复用图换成 file_id 引用，或减图。GIF 动图按帧怎么处理官方未展开，有动图需求先实测再上量。
常见问题
- 多张图的 token 怎么算？每张图独立按同一规则折算（各自上限约 1024 token），没有多图打包优惠；600 张的量级要按 600×1024 估算输入 token，账单口径见官方 Token 计算页。
- 从 Kimi 迁移要改什么？Kimi 不支持公网图片 URL（用 base64 或 ms://），DeepSeek 支持公网 URL——链接能用的场景可以直接省掉编码步骤；反过来从 DeepSeek 迁去 Kimi，公网 URL 全部要换成 base64。
- 网页版发图和 API 一样吗？不一样：网页端拖图进对话框即可，这篇讲的都是 API 侧规则；日常读图不写代码的话，直接在DeepSeek网页版用就行。
信息来源
- DeepSeek 官方「Vision」指南（api-docs.deepseek.com/guides/vision，核对时间 2026-11-03）：三种传法、格式按内容检测、detail 四档语义、自动缩放与单图约 1024 token 上限、Limits 表（600 张/32 MiB/64 MiB/200 MiB/8192 px）、user 消息限制、Anthropic 与 Responses API 块结构；
- DeepSeek 官方定价页（api-docs.deepseek.com，核对时间 2026-11-03）：视觉能力仅 deepseek-flash 支持；
- 站内条目：DeepSeek（工具页）、Kimi 图片输入、DeepSeek 联网搜索 API。
