Skip to main content
POST
Messages with vision: DeepSeek V4 Flash Vision (Anthropic format)
這個端點的令牌必須是 ClaudeCode 分組,這是硬要求。default 分組會撞上兩個疊加問題:
  1. 不顯式傳 top_p 一律返回 400 Invalid top_p value
  2. 就算補上 top_p,把第一輪返回的 thinking 塊原樣回傳到第二輪會報 unknown variant 'thinking', expected one of 'text', 'image_url', 'file' —— 而 Claude Code、Anthropic SDK 這類標準客戶端一定會原樣回傳,所以多輪必斷
換成 ClaudeCode 分組,兩個問題都不存在。OpenAI 格式請改用 Chat 線上除錯
右側 Playground 可直接除錯:在 x-api-keysk-your-apiyi-keyClaudeCode 分組的令牌, 不帶 Bearer 字首),anthropic-version 保持 2023-06-01。 預設示例用的是一張公網圖片、並已關閉深度思考,點擊發送即可看到響應。

引數說明速查

兩種傳圖方式

source.type = "base64"

注意 data 不含 data:image/jpeg;base64, 字首(這一點和 OpenAI 格式不同)。

source.type = "url"

source.type = "url" 只有 ClaudeCode 分組支援default 分組會報 You have uploaded an unsupported imagesource.type = "file" 需要 Files API,本平臺不提供。

響應的 content 是塊陣列

ClaudeCode 分組返回的 thinking 塊帶 signature 欄位,流式下也有 signature_delta

多輪與工具閉環

把上一輪 assistant 的整個 contentthinking 塊,不要剝)原樣放回 messages, 再追加 tool_result 即可:
實測第二輪正常返回。這一步正是 default 分組會 400 的地方,也是 Claude Code 等客戶端 的必經路徑 —— 所以分組不能選錯。

快取欄位的口徑

自動字首快取生效,對映到 Anthropic 標準欄位: 含圖請求第 3 次呼叫才開始命中(純文本第 2 次)。把固定的長指令放在圖片前面才能進快取。

常見報錯

授權

x-api-key
string
header
必填

API易令牌,直接填 sk- 开头的 Key。分组必须为 ClaudeCode

標頭

anthropic-version
string
預設值:2023-06-01
必填

Anthropic API 版本号,固定 2023-06-01

主體

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

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

可用選項:
deepseek-v4-flash-vision-exp
max_tokens
integer
預設值:800
必填

最大输出 tokens(Anthropic 格式下必填),硬上限 393,216。开思考建议 2000 以上

必填範圍: x <= 393216
messages
object[]
必填

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

system
string

系统提示词

thinking
object

深度思考开关。传 {"type": "disabled"} 关闭后 content 只剩 text 块,本端点两个分组都生效

stream
boolean
預設值:false

是否流式输出(SSE)。事件为 Anthropic 标准的 message_start / content_block_delta / message_stop 等

temperature
number

采样温度

top_p
number

核采样阈值。ClaudeCode 分组下可省略;default 分组下不传必返回 400

top_k
integer

候选截断

stop_sequences
string[]

停止序列

tools
object[]

工具列表,Anthropic 标准 input_schema 格式。实测含流式增量拼装与完整两轮闭环

回應

生成成功

id
string
type
string
role
string
model
string
content
object[]

内容块数组。开启思考时为 [thinking, text],关闭后只剩 [text];调用工具时为 [thinking, tool_use]

stop_reason
string
usage
object

用量。注意与 OpenAI 格式口径不同:命中缓存后 input_tokens 只剩未命中部分,不能与 prompt_tokens 直接对账