| | |
DeepSeek-V4.1-Flash 系列对话前缀续写行为调整 | | - 升级前：当请求以 assistant 消息结尾时，即使未显式开启前缀续写，也可能进入续写模式。
- deepseek-v4-1-flash-260910、deepseek-v4-1-flash-261017 将按原厂规则处理前缀续写。
- Chat API 仅在末条消息 role=assistant 且 prefix=true 时开启续写。
- Responses API 通过 partial=true 开启续写，未传或传入 false 时按普通回复处理。
|
DeepSeek-V4.1-Flash 系列图像输入能力对齐原厂 | Chat API Responses API Messages API | - 升级前：单张图片大小、单次请求图片数量以及 detail 档位受固定配置限制。
- URL 或 Base64 单张图片大小上限由 10 MiB 提升至 50 MiB。
- 单次请求图片数量上限提升至 3600 张，并新增 URL 图片总大小 200 MiB 限制。
- Chat API 与 Responses API 支持 detail=original，detail=auto 默认按 original 处理。
- Messages API 对 detail 保持兼容但不生效。
|
Responses API 支持 apply_patch 和 custom tool | | - 升级前：apply_patch 及自定义工具类型可能因工具类型校验失败，无法被 Codex 客户端正常执行。
- 升级后：支持包含 apply_patch 和 custom tool 的请求与流式返回，可返回由 Codex 客户端执行的 diff 工具调用。
|
Responses API 兼容 namespace 与工具懒加载字段 | | - 升级前：namespace、defer_loading 等 Codex、MCP 工具分组与懒加载字段可能触发严格校验并返回 400 错误。
- 升级后：兼容 namespace、defer_loading 等字段；传入 type=namespace 时，不再因工具类型校验直接报错。
|
支持 prompt_cache_key 并增强缓存亲和 | | - 升级前：请求体顶层不支持传入 prompt_cache_key。
- 升级后：Chat API 与 Responses API 支持在请求体顶层传入 prompt_cache_key，用于增强缓存亲和。
|
Messages API SSE 增加 ping 事件 | | - 升级前：流式返回中不发送 Anthropic 兼容的 ping 事件。
- 将在首个业务事件后增加 event: ping，其中 data 为 {"type":"ping"}。
- 该事件不参与内容拼接、usage 统计、Token 计算和计费。
|
Messages API 错误返回格式对齐 Anthropic | | - 升级前：错误响应缺少顶层 type 和 request_id，且 error.type 使用方舟错误类型。
- deepseek-v4-1-flash-261017 和 deepseek-v4-1-flash-economy-261017 的错误响应将新增顶层 type="error" 与 request_id。
- error.type 将映射为 Anthropic 兼容类型；方舟已有的 code、param 和 message 字段继续保留。
|
| | - 升级前：传入 stream_options.include_usage 后，结束内容 chunk 和独立统计 chunk 可能重复返回相同的 usage。
- deepseek-v4-1-flash-261017 和 deepseek-v4-1-flash-economy-261017 默认在包含 finish_reason 的结束内容 chunk 中返回一份有效 usage。
- 显式传入 include_usage 后，不再额外重复返回独立 usage chunk。
|
Responses API reasoning summary 事件字段补齐 | | - 升级前：response.reasoning_summary_part.added 事件中的 part 缺少 text 字段，且部分类型未对齐 reasoning_text。
- 升级后：该事件将新增 part.text，并适配 type=reasoning_text，提升严格 Schema 客户端的反序列化兼容性。
|
logprobs、top_logprobs 参数支持 | | - 升级前：API 不支持传入 logprobs、top_logprobs。
- 升级后：DeepSeek V4 正式版系列、GLM-5.2 将支持 logprobs、top_logprobs 传入和输出。
|
| | - 升级前：当 content 的 role=developer 时会返回报错。
- 升级后：将兼容 role=developer 输入，不再报错。
|
Responses API 默认输出加密后的思考内容 | | - 升级前：如需返回 reasoning.encrypted_content，需在请求中显式传入 "include": ["reasoning.encrypted_content"]。
- 升级后：当模型产生思考内容时，将默认返回 reasoning.encrypted_content，无需显式传参。
|
| | - 升级前：流式输出中部分字段无有效内容时会省略返回。
- response.created、response.in_progress 事件将新增 status 和 output 字段返回；无内容的场景下则为空数组。
- response.output_item.added 事件中，reasoning item 将新增 summary 字段返回，message item 将新增 content 字段返回；无内容的场景下则为空数组。
|
| | - 升级后：方舟 API 将支持原生 web_search 工具调用，并支持搜索事件和结果回传。
|
在 codex 场景下新增对 phase=commentary、final_answer 的支持 | | - 升级后：codex 场景下，API 将新增对 phase 字段输入和输出的支持。
|
usage 中新增返回 cache_creation_input_tokens 字段 | | - 升级前：usage 中不返回 cache_creation_input_tokens 字段。
- 返回的 usage 中将新增 cache_creation_input_tokens 字段。
|
DeepSeek 系列 stop、stop_sequence 数组上限由 4 个提升至 16 个 | | - 升级前：DeepSeek 系列支持的 stop、stop_sequence 数组上限为 4 个，配置超过 4 个会报错。
|
| Chat API Responses API Messages API | - 升级前：模型收到自身不支持的模态输入时会直接报错并拒绝请求。
- 升级后：GLM-5.2、DeepSeek V4 正式版系列收到图片、视频或音频等非模型支持模态时，不再直接报错。
|
请求输入无法解析的 encrypted_content、signature 不再报错 | Chat API Responses API Messages API | - 升级前：API 接收到无法解析的 encrypted_content、signature 时会直接报错。
- 升级后：将兼容无法解析的 encrypted_content、signature 内容输入，不会直接报错。
|
请求输入的 content 为部分非法内容时不再报错 | Chat API Responses API Messages API | - 升级前：API 接收到 content 为 null、空等非法内容输入时会直接报错。
- 升级后：将兼容部分场景的非法 content 输入，不会直接报错。
|
| | - 升级前：API 接收到 tool_call_id 为 null、空字符串等非法输入时会直接报错。
- 升级后：将兼容部分场景的非法 tool_call_id 输入，不会直接报错。
|
火山方舟
复制全文
下载 pdf
文档反馈
问问助手