Skip to main content
POST
Chat completion with vision: DeepSeek V4 Flash Vision
调试前先确认令牌分组是 defaultClaudeCode 分组的令牌调这个端点虽然也返回 200,但 detail、思考开关、logprobs 三个参数全部失效,响应里还会缺 completion_tokens_details 字段 —— 看起来像参数写错了, 实际是分组不对。Anthropic 格式请改用 Messages 在线调试
右侧 Playground 可直接调试:在 AuthorizationBearer sk-your-api-key, 默认示例用的是一张公网图片、并已关闭深度思考,点击发送即可看到响应。 换成本地图片时把 image_url.url 改成 data:image/jpeg;base64,<BASE64>

参数说明速查

三种传图方式

image_url + base64 data URL

image_url + 公网外链

外链最长 8192 字符,需 60 秒内下载完成。

file 块 + file_data

image_url 通道折出的 tokens 完全一致(同一张图都是 303)。
file 块上的 detail 会被静默忽略 —— 不报错,但也不省 token。 要用 detail: "low" 省钱,必须走 image_url 通道。另外 file_id(Files API)在本平台不可用,传了会报 invalid file_id

detail 能省多少

同一张 1600×1200 的图,四个档位实测: 判断图片类型、认主体、粗分类这类任务用 low 就够;要读小字、认图表数值才需要 original 填了枚举外的值会明确报错: unknown variant 'ultra', expected one of 'low', 'high', 'original', 'auto'

图片怎么折成 token

单图上限 384,多图各自独立计数、线性叠加。上传前预压缩只省带宽、不省 token —— 2000² 与 4000² 折出来完全一样。完整规律见 概览

关思考的两种写法

两种都实测可靠(各 3 次,prompt_tokens 从 303 降到 223,reasoning_content 消失)。 reasoning: {"effort": "none"}enable_thinking: false 都无效
max_tokens 给小了会返回空 content。开着思考时,一句话问题也可能先输出几百 tokens 的思考内容,配额用尽就是 finish_reason: "length" 加空字符串 —— 很容易误判成模型没回答。 开思考建议 2000 以上,或者干脆关掉。

需要结构化输出?用 tools

response_format: {"type": "json_schema"} 会返回 This response_format type is unavailable now(上游模型侧限制)。 json_object 可用,但不约束字段;要强约束请用 Function Call:
流式下工具参数也会正确增量拼装。

常见报错

授权

Authorization
string
header
必填

在 API易控制台获取的 API Key,分组需为 default

请求体

application/json
model
enum<string>
默认值:deepseek-v4-flash-vision-exp
必填

模型 ID,固定 deepseek-v4-flash-vision-exp

可用选项:
deepseek-v4-flash-vision-exp
messages
object[]
必填

对话消息数组。content 可以是字符串(纯文本),也可以是内容块数组(图文混合)

max_tokens
integer
默认值:800

最大输出 tokens,硬上限 393,216。开启思考时思考内容也计入,开思考建议 2000 以上,否则可能返回空 content

必填范围: x <= 393216
thinking
object

深度思考开关。传 {"type": "disabled"} 可关闭,省 80 输入 tokens 与全部思考输出。仅 default 分组生效

reasoning_effort
enum<string>

思考深度分档。实测 none 可确定性关闭思考;low/high/max 之间未观察到稳定差异。仅 default 分组生效

可用选项:
none,
low,
medium,
high,
max
stream
boolean
默认值:false

是否流式输出(SSE)。配合 stream_options.include_usage 可在末尾获取用量

response_format
object

输出格式。只支持 {"type": "json_object"};json_schema 会报 This response_format type is unavailable now

temperature
number

采样温度

top_p
number

核采样阈值

stop
string[]

停止词

seed
integer

随机种子

logprobs
boolean

是否返回 token 对数概率,实测有内容返回(仅 default 分组)

top_logprobs
integer

每个位置返回的候选数,取值范围 0-20

必填范围: 0 <= x <= 20
tools
object[]

Function Call 工具列表,OpenAI 标准格式。需要结构化输出时用它替代 json_schema

响应

对话补全成功

id
string

请求 ID

object
string
model
string
choices
object[]

补全结果。message 中除 content 外,开启思考时还有 reasoning_content 字段

usage
object

用量。图片折算出的 tokens 计入 prompt_tokens