Omni 传输守卫与缓存
控制上传限制、派生预算、降质披露和临时文件清理。
This page has not been translated into English yet. The original Chinese version is shown below.
omni 实验分支把主动预处理与强制传输守卫分开。即使没有固定策略，超过最终上传限制的媒体仍需降质；处理成功也不代表原始质量完整保留。
强制守卫
默认 image-downsample、video-downscale、audio-downsample 三条策略分别调用对应降采样工具。可整条覆盖，不可删除；合并后必须继续覆盖 image、video、audio。
守卫不能声明 when，因为触发条件就是传输超限；output.source 必须为 omit，不能把已知超限的源文件留在最终集合。最多执行 maxTransportPasses 轮，仍不符合限制时用媒体省略说明替代。
omni.processing.transportGuard.maxUploadFileBytes 不得超过 1GiB。这是实验配置的上界，并非所有模型、区域或上传接口都承诺接收 1GiB；实际服务端仍可因更低限制拒绝，触发降质重试。
每根资源的预算
| limits 字段 | 默认 |
|---|---|
| maxConcurrentResources | 1 个根资源并发 |
| reservedOutputTokens | 8192，预算表中唯一允许 0 的键 |
| maxLineageDepth | 8 |
| maxPolicyRunsPerRoot | 64 |
| maxArtifactsPerRoot | 256 |
| maxDerivedBytesPerRoot | 1GiB |
| maxTransportPasses | 3 |
字段位于 omni.processing.limits。大视频可能同时生成音轨、片段和多张图，派生总量可能超过源文件本身体积。预算耗尽阻止新派生，不追溯撤销已经提交的投递；不要把它当作精确的模型费用硬上限。
对模型披露的内容
媒体降质标记说明原尺寸、时长到产物的变化及丢失信息；媒体转写标记附文本证据；媒体省略标记说明没有发送原资源。服务端超限导致再次处理时还会标出重试轮次。
这类说明应紧邻对应产物，使模型能区分完整音轨、转写文本、稀疏帧与截取片段。转写不保留所有语气或非语音细节，裁剪以外的区间不能从单个片段推断。
存储和复用
派生产物放在 .qwen/omni/objects/sha256/<xx>/<hash>.<ext>。降质缓存依据源哈希和策略身份复用已有结果，改变策略可能需要重新派生。
上传缓存按文件哈希、上传模型、endpoint 和 key 隔离。omni.delivery.upload.urlTtlHours 最多 48 小时；只改变推理地址不会自动使上传缓存失效。临时 oss:// URL 复用不等于推理调用免计费。
失败调用的暂存残留移到 quarantine/
出错时先核对哪一层
启动 OmniPolicyConfigError 先查策略字段、禁用工具、无下游的 reprocessMedia 和守卫覆盖。处理中超时则检查工具参数、文件规模、墙钟预算与外部模型；有成功产物也要查转写内嵌的失败段。
上传拒收或速率限制与本地转码不是同一问题。先读媒体省略和重试说明，确认实际送达了哪些证据，再决定重试或进一步裁剪。官方案例的成功次数、速度和费用不能推广为任何媒体的保证。