deepseek-v4-flash-vision-exp- AI开放文档

支持接口地址

POST https://gw.hbapis.com/v1/chat/completions,
/v1/responses,

/v1/messages

API 支持

用户可以通过设置 model='deepseek-v4-flash-vision-exp' 来访问 V4-Flash-Vision-Exp 模型的 API。在 API 服务中，图片会转换成 token 后按 token 计费，一张图片最多占 384 tokens，计费价格与 V4-Flash 模型一致。

多模态 API 支持 Chat Completions、Messages、Responses 三种格式调用，可以方便接入各类 Agent 工具中使用，支持图文混合输入，支持 base64 内联、外部 URL、Files API 三种图片传入方式

如何使用

共有三种方式向模型提供图片，均使用标准的 OpenAI 兼容对话补全格式，即 content 为一个块（block）数组，而非纯字符串。同样的三种方式也适用于 Responses API，图片以 input_image 内容块承载。

能力支持

deepseek-v4-flash-vision-exp 模型支持在文本之外输入图片，你可以让模型描述图片、识别截图中的文字、分析图表等。

支持的图片格式：JPEG、PNG、GIF、WebP。格式由文件实际内容判断，而非文件名或声明的 MIME 类型

鉴权方式

使用 Bearer Token 鉴权，在请求 Header 中添加 Authorization 参数：

Authorization: Bearer YOUR_API_KEY

请求参数

请求头

Content-Type

类型：string

必填：否

说明：application/json

Authorization

类型：string

必填：是

说明：Bearer YOUR_API_KEY

请求体

model

类型：str；必填：是；说明：模型名称，例如 glm-5.3-flash。

messages

类型：array；必填：是；说明：对话消息列表。

messages[].role

类型：str；必填：是；说明：消息角色。

messages[].content

类型：str；必填：是；说明：消息内容。

thinking

类型：object；必填：否；说明：思考配置。

thinking.type

类型：str；必填：否；说明：思考类型。

reasoning_effort

类型：str；必填：否；说明：支持 low、high 和 max。

max_tokens

类型：int；必填：否；说明：最大输出 Tokens。

temperature

类型：float；必填：否；说明：采样温度。

请求示例

示例 1,Base64 编码图片（内联）：

外部图片 URL

传入一个可公开访问的 http(s) 链接，模型会自动下载图片。URL 长度最多 8192 个字符，图片文件最大 32 MiB，且需在 60 秒内完成下载。如果链接超长，请改用 base64 data URL 或 Files API。

response = client.chat.completions.create(
model="deepseek-v4-flash-vision-exp",
messages=[
{
"role": "user",
"content": [
{"type": "text", "text": "描述一下这张图片。"},
{
"type": "image_url",
"image_url": {"url": "https://example.com/image.jpg"},
},
],
}
],
)
print(response.choices[0].message.content)

引用通过 Files API 上传的文件

通过 Files API 上传一次图片，之后在请求中用其 file_id 引用。当你需要在多个请求中复用同一张图片，或图片会让请求体超过 48 MiB 内联限制时，这是最佳选择。与内联图片不同，通过 Files API file_id 引用的图片最大可达 64 MiB，且不受 32 MiB 单图检查限制。

使用 file 内容块，填入返回的 file_id（形如 file-api-...）：

response = client.chat.completions.create(
model="deepseek-v4-flash-vision-exp",
messages=[
{
"role": "user",
"content": [
{"type": "text", "text": "这张图片里有什么？"},
{"type": "file", "file_id": "file-api-xxxxxxxxxxxxxxxx"},
],
}
],
)
print(response.choices[0].message.content)

返回响应

成功请求返回 HTTP 200。不同端点的响应结构可能不同。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

API Key

在 header 添加参数

x-api-key

示例：

x-api-key: ********************

deepseek-v4-flash-vision-exp

支持接口地址#

API 支持#

如何使用#

能力支持#

鉴权方式#

请求参数#

请求头#

请求体#

请求示例#

示例 1,Base64 编码图片（内联）：#

外部图片 URL#

引用通过 Files API 上传的文件#

返回响应#

请求参数

请求示例代码

返回响应

支持接口地址

API 支持

如何使用

能力支持

鉴权方式

请求参数

请求头

请求体

请求示例

示例 1,Base64 编码图片（内联）：

外部图片 URL

引用通过 Files API 上传的文件

返回响应