企业官网建设流程全解析

DeepSeek API 文档介绍

提供 DeepSeek API 文档，有语言选择，包括 English 和中文（中国），还有 DeepSeek 平台相关内容，如快速开始、API 指南、API 参考、新闻、其他资源、常见问题解答、更新日志等。

视觉模型特点

‘deepseek - v4 - flash - vision - exp’ 模型支持同时接收图像和文本，可描述图片、读取截图文本、分析图表等。支持的图像格式有 JPEG、PNG、GIF 和 WebP，系统根据文件实际内容识别图像格式。

发送图像的方式

有三种向模型提供图像的方式，均采用与 OpenAI 兼容的聊天补全格式，‘content’ 是数据块数组。同样适用于响应 API，图像包含在 ‘input_image’ 内容部分。

1. Base64 编码的图像（内联）：将图像编码，以 ‘data:’ URL 形式嵌入请求，适合本地文件。编码后数据会计入 48 MiB 的请求体大小限制。给出了 Python 和 bash 代码示例。

2. 外部图像 URL：传递可公开访问的 ‘http(s)’ 链接，模型自动下载图像。URL 长度最多 8192 个字符，图像文件大小最多 32 MiB，下载须在 60 秒内完成。过长链接建议用 Base64 数据 URL 或文件 API，并给出 Python 代码示例。

3. 引用通过文件 API 上传的文件：使用文件 API 上传图像，在请求中引用其 ‘file_id’。适用于多次使用同一图像或请求体超 48 MiB 限制的情况。通过文件 API ‘file_id’ 引用的图像大小最大可达 64 MiB，不受单张图像 32 MiB 大小限制。给出了使用 ‘file_id’ 和 ‘file_data’ 的代码示例。

细节级别设置

对于 ‘image_url’ 输入，可设置 ‘detail’ 字段控制图像处理方式，有 ‘low’、‘high’、‘original’、‘auto’ 四种值，并给出了 JSON 代码示例。

何时使用文件 API

内联图像会计入 48 MiB 的请求体大小限制，以下情况建议使用文件 API：单个请求超出请求体大小限制；图像大小超过 32 MiB；需要在多个请求中引用同一图像并避免重复上传。

令牌使用规则

图像根据尺寸转换为令牌，与文本令牌一起计费。推理前每张图像自动调整大小，总像素数低于约 384×384 的图像放大，较大图像缩小使总像素数约为 800×800 图像的像素数。每张图像的令牌上限为 384 个，多图像请求中每张图像独立计算。可使用令牌与令牌使用页面上的图像令牌计算器估算特定尺寸图像的令牌成本。

限制条件

包括支持的格式（JPEG、PNG、GIF、WebP）、外部 URL 长度（8192 个字符）、请求体大小（48 MiB）、最大单张图像大小（Base64 / 外部 URL 为 32 MiB，文件 API ‘file_id’ 为 64 MiB）、每个请求的最大图像数量（600）、每个请求的最大图像总大小（不包含 ‘file_id’ 图像时为 64 MiB，包含时最大可达 200 MiB）、最大图像尺寸（每边 8192 像素，请求包含 15 张或更多图像时每边降至 4096 像素）。有关文件 API 上传文件的存储和上传配额，参阅文件 API：限制。

还有其他限制条件，仅 ‘user’ 消息支持包含图像，‘system’ 或 ‘assistant’ 消息包含图像会返回 400 错误；只有视觉模型（‘deepseek - v4 - flash - vision - exp’）支持接收图像，其他模型返回 400 错误；用户文本中包含保留的图像占位符令牌会被拒绝并返回 400 错误。

通过 Anthropic API 使用图像

除与 OpenAI 兼容的端点外，还可通过与 Anthropic 兼容的 ‘/messages’ 端点发送图像。Anthropic 使用 ‘image’ 块，‘source’ 对象的 ‘type’ 可以是 ‘base64’、‘url’ 或 ‘file’，并给出了 Python 代码示例。三种 ‘source’ 类型与 OpenAI 方法对应，各有注意事项。

通过响应 API 使用图像

‘deepseek - v4 - flash - vision - exp’ 模型支持通过与 OpenAI 兼容的响应 API 接收图像，适用三种输入方法和相同限制，仅内容部分格式不同，图像包含在 ‘input_image’ 部分。‘input_image’ 部分支持 ‘detail’ 字段，通过 ‘file_id’ 提供图像时，‘detail’ 字段忽略，‘image_url’ 和 ‘file_id’ 互斥。有关字段语义、限制条件和工具输出图像的详细信息，参阅响应 API 指南。