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 指南。
