主题
更新日志
本页记录客户端能观察到的行为变更：协议兼容性、端点、参数处理和文档修订。 仅影响服务端内部的改动不在此列出。
2026-09-07
新增多模态视频生成端点（Contents 口径）
POST /api/v3/contents/generations/tasks
GET /api/v3/contents/generations/tasks/{task_id}一次请求可同时给出文本、参考图、参考视频和参考音频。与既有的 Synthesis 口径 （/v1/services/aigc/video-generation/video-synthesis）请求体、任务查询路径和状态 取值都不同，不能互换。请求格式见 API 端点。
需要注意的行为：
content与prompt互斥，同时传返回400- 携带
tools（含联网搜索）的请求会被拒绝 —— 该能力在上游按调用次数独立计价， 网关没有对应计费维度，静默丢弃会让你误以为已启用 - 顶层字段与提示词里的
--resolution/--duration/--frames简写取值冲突时返回400，不会取其中一个 - 任务状态为小写（
queued/running/succeeded/failed），Synthesis 口径是大写
图片生成支持多图参考与图层拆分
部分图片模型在 /v1/images/generations 之上新增 image（字符串或数组）和 layer_decomposition 参数。这类模型不支持 stream —— 流式拿不到完整的 usage.input_images 和每张图的 size，按张计费无法结算。详见 API 端点。
新增两种计费方式说明
计费说明 补充「按 Token 计费的视频」和「按张计费的图片」两节， 包含预扣与结算规则、锁价时机、失败退款和未配价档位的拒绝行为。此前计费表只覆盖 按秒和按尺寸两种计量方式。
2026-09-02
新增 请求兼容性修正 文档页
集中说明 Zivv 在转发前对 Anthropic Messages 请求做了哪些自动修正，以及哪几项会改变 语义。此前这些修正一直生效但未公开，导致同一份请求「直连上游 400、经 Zivv 成功」时 无从查证。无需客户端改动。
新增三项请求兼容性修正
- 没有配对
tool_result的孤儿tool_use→ 自动补一条占位结果。会改变模型看到的 内容，详见说明 - 已废弃的
output_format字段 → 自动迁移为output_config.format - 其他厂商的
thought_signature字段 → 自动剔除
三项此前都会导致整个请求被拒。
文档修订
- API 端点：更正 Anthropic Messages 的
temperature说明 ——该参数接受但不生效，转发前会被剔除（当前模型代际已移除它） - API 端点：补充
max_tokens的缺省与收敛行为
2026-08-30
response_format 不再注入提示词
客户端传 response_format: {"type": "json_schema"} 时，此前会向 system 注入一段 格式说明提示词。现改为映射到上游原生的结构化输出能力（output_config.format）， 不再注入任何提示词。
json_schema形态：schema 原样传给原生结构化输出，约束更严格json_object形态：不再有等价的原生表达，改为不做任何处理——若你依赖它约束输出， 请改用json_schema并提供具体 schema
同时适用于 OpenAI Chat Completions 与 Responses 两个入口。
2026-08-24
不支持对话中途 system 的模型：自动折叠
这类模型上带中途 role: "system" 消息此前必然 400。现改为：开头连续的折进顶层 system（无损），中途的并入前一条 user 消息（有损，指令优先级降级）。