复现:generate_media 把 size 写成 9:16 这类比例值(模型只接受像素尺寸),或 durationSeconds 低于模型下限时,工具结果只有一句「工具执行失败」,整轮终止;模型不知道错在哪个参数,用户要求重试时原样再错。 原因:尺寸、时长、比例、分辨率不在模型支持范围时,能力校验的拒绝和其它准入失败一样被包成不可重试的 media_admission_failed。 修法:这类拒绝改报字段级参数错误,带上原因与取值来源,走已有的 fix_arguments 纠正通道;仍然没有任务被提交,也不产生费用。另外把准入拒绝的原始原因写进服务端日志(工具结果里的原因会脱敏,日志内容是服务端校验错误文本,不含用户内容或密钥)。
40 lines
2.5 KiB
Go
40 lines
2.5 KiB
Go
package app
|
||
|
||
import "strings"
|
||
|
||
// 模型能力校验(model_capability_validate.go)拒绝的生成参数属于「模型填错了参数」,
|
||
// 不是模型、权限或预算问题。此前它们和其它准入失败一样被包成不可重试的
|
||
// media_admission_failed:工具结果只有一句「工具执行失败」,整轮直接终止,
|
||
// 模型既不知道错在哪个参数,也没有机会改正;用户要求重试时它只能原样再错一次。
|
||
//
|
||
// 这里把这类错误改报为字段级参数错误:结果里带着具体原因和取值来源,
|
||
// 走已有的 fix_arguments 纠正通道(次数仍受 cloudAgentToolAttemptLimit 限制),
|
||
// 没有任何任务被提交,也不会产生费用。
|
||
var cloudAgentMediaCapabilityArgumentHints = []struct {
|
||
marker string
|
||
field string
|
||
hint string
|
||
}{
|
||
{"图片尺寸不在当前模型支持范围内", "size", "size 必须取 model_list 返回的该模型 options.image.size.values 中的一个值(通常是像素尺寸,例如 1536x2752),不要写 9:16 这样的比例"},
|
||
{"当前分辨率不支持所选图片宽高比", "size", "所选 quality 档位下没有这个宽高比;按 model_list 返回的该模型 options.image.size.presets 选一组匹配的比例与分辨率"},
|
||
{"图片质量不在当前模型支持范围内", "quality", "quality 必须取 model_list 返回的该模型 options.image.quality.values 中的一个值,或省略"},
|
||
{"视频时长不在当前模型支持范围内", "durationSeconds", "durationSeconds 必须落在 model_list 返回的该模型 options.video.duration 给出的范围或固定值内"},
|
||
{"画面比例不在当前模型支持范围内", "size", "视频的 size 必须取 model_list 返回的该模型 options.video.ratios 中的一个比例"},
|
||
{"输出分辨率不在当前模型支持范围内", "quality", "视频的 quality 必须取 model_list 返回的该模型 options.video.resolutions 中的一个值,大小写保持一致"},
|
||
}
|
||
|
||
// cloudAgentMediaCapabilityArgumentError 识别能力校验错误并转成可纠正的参数错误;
|
||
// 其它错误返回 nil,由调用方按原口径处理。
|
||
func cloudAgentMediaCapabilityArgumentError(err error) error {
|
||
if err == nil {
|
||
return nil
|
||
}
|
||
message := err.Error()
|
||
for _, item := range cloudAgentMediaCapabilityArgumentHints {
|
||
if strings.Contains(message, item.marker) {
|
||
return cloudAgentFieldError(item.field, "unsupported_value", item.marker+";"+item.hint+"。未提交生成任务,改正后可直接重新调用")
|
||
}
|
||
}
|
||
return nil
|
||
}
|