想让程序看一张商品图、截图或图表，可以用 DeepSeek V4.1-Flash 的 API。下面用一份 Python 小工具把本地图片发给模型，再把识别结果显示在终端；你需要一个 DeepSeek API Key，调用会按 token 计费。

你需要准备

项目 说明
账号 DeepSeek 开放平台账号和 API Key：创建 Key
电脑 能运行 Python 3 的 Mac；脚本只用 Python 标准库，不需要额外安装包
图片 JPEG、PNG、GIF 或 WebP，单张不超过 32 MiB
费用 按输入和输出 token 计费；图片也会计入输入用量，运行前先核对当前价格

V4.1-Flash 是 DeepSeek API 上支持图像理解的模型。当前模型名是 deepseek-flash；官方 API 兼容 OpenAI Chat Completions 格式，文档列出的上下文长度为 1M、最大输出为 384K tokens。模型名、图片格式和尺寸限制以官方图像理解说明为准。

下载可运行的示例工具包

下载并解压 DeepSeek Flash 图片调用工具包。里面有：

  • deepseek_flash_vision.py：把一张本地图片发给 API 并打印回答；
  • README.md：环境变量和运行说明；
  • test_deepseek_flash_vision.py：不联网、不调用 API 的本地自检。

如果你的 Mac 没有 Python 3，先看Python 与 uv 入门教程。

第一步：在当前终端输入 API Key

在 DeepSeek 开放平台创建 API Key 后，打开终端，输入：

printf '粘贴 API Key 后按回车（输入不会显示）：'
read -s DEEPSEEK_API_KEY
printf '\n'
export DEEPSEEK_API_KEY

粘贴 Key 时屏幕不会显示字符，粘贴后按回车。Key 只留在当前终端会话的环境变量里；不要把它写进脚本、截图或发给别人。使用完成后可以运行 unset DEEPSEEK_API_KEY 清除它。

第二步：让模型看本地图片

打开解压后的工具包文件夹，在终端运行：

python3 deepseek_flash_vision.py /你的图片路径/商品图.jpg \
  --prompt "请描述图中商品的外观，并逐字抄出能看清的文字。看不清的内容请标注无法辨认。" \
  --detail low

把 /你的图片路径/商品图.jpg 换成实际图片路径。脚本会显示模型回答和 API 返回的 token 用量。图片经 API 发送到 DeepSeek 服务，不会只在本机处理；不要上传未经授权的人像、客户资料或其他敏感图片。

--detail low 会先把图片缩小到 512×512，适合识别大致内容，通常也会减少图像 token。需要读小字时，改成 --detail original，但请人工核对文字和数字。模型可能漏读或猜错，不能把识别结果当作最终事实。

模型名和价格怎么理解

旧代码如果使用 deepseek-v4-flash 或 deepseek-v4-flash-vision-exp，官方目前仍提供兼容转发，但建议改成 deepseek-flash。deepseek-chat 和 deepseek-reasoner 已停用；V4-Pro API 目前仍提供，名称为 deepseek-v4-pro，但不支持图像输入。可看DeepSeek 模型选择说明了解差异。

截至 2026-10-09，官方价格如下，单位为人民币/百万 tokens：

计费项 空闲时段 高峰时段
输入，缓存命中 ¥0.02 ¥0.04
输入，缓存未命中 ¥1 ¥2
输出 ¥4 ¥8

北京时间工作日（不含中国法定节假日）9:00–12:00、14:00–18:00 是高峰时段，其他时间是空闲时段。图片按尺寸换算成输入 token；每张图片最多按 1024 个图像 token 计，完整规则见官方模型与价格页。价格可能调整，正式调用前请重新核对官方页面。

拿它做什么、怎么交付

你可以用它先整理一批商品图的外观描述、读取截图上的可见文字，或把图表内容转成文字草稿。接单时把“模型识别结果”和“人工复核后的交付稿”分开保存，让客户知道哪些信息经过逐项确认；报价根据图片数量、复核工作和交付格式核算，并先查看同类服务报价，不要把 API 输出直接当合格成品。

常见问题

这是不是本地运行？ 不是。脚本从本机读取图片，再发到 DeepSeek API；图片会离开你的电脑。需要离线或不能上传图片时，改用本地视觉模型，并先按电脑配置和模型许可选型。

API Key 从哪里拿？ 在DeepSeek 开放平台 API Keys创建。API 调用会产生费用；不要把 Key 写进脚本或提交到代码仓库。

哪些图片可以传？ 官方支持 JPEG、PNG、GIF、WebP。单张内联图片上限 32 MiB，整个请求体上限 48 MiB；超过限制时需要缩小图片或使用官方 Files API。脚本为简单起见只处理一张不超过 32 MiB 的本地图片。

模型权重能下载吗？ DeepSeek 在 Hugging Face 提供了官方权重仓库。仓库页面约 510GB；本教程只演示 API 调用，没有在个人电脑上部署或验证本地推理。

工具清单

工具 用途 入口
DeepSeek API 通过 API 发送文本和图像，按 token 计费 模型与价格 · 首次调用
图片调用工具包 用 Python 标准库发送一张本地图片 下载 ZIP

AI 生成内容说明：本文的封面背景由 AI 生成，标题由脚本排版；封面不含真人照片。