docs(skill): model-auto-config补媒体转换铁律(上行b64media2url/下行downloadfile2url,每个生成类profile必查+核对清单)

This commit is contained in:
yumoqing 2026-09-05 15:28:39 +08:00
parent 523ddf451d
commit 0b0952c95a

View File

@ -52,6 +52,33 @@ llm_model 的 price_input/price_output/cost_input/cost_output 四字段已删除
price_factors: duration 或 flat分辨率等做 filter 维度);价格照文档原文
记录,禁止换算推导(详见定价数据格式技能)。
## 媒体转换铁律2026-09-05 用户定夺——每个 llm_api_profile 配置必查)
生成类模型t2i/i2v/t2v/tts/i2i/v2v/3d 等出参是文件的能力)的适配模板
`llm_api_profile`**data 和 response 必须处理两个媒体转换逻辑**
- **上行request_template / data**:上传/本地媒体一律 `xxx_file` 命名,
`{{ b64media2url(request, params.image_file) }}` 转成本地公网 URL
再传上游base64 落盘 → /idfile 公网地址;已是 http/https URL 则原样透传)。
- **下行response_template**:上游生成物 URL 用
`{{ downloadfile2url(request, output.video_url) }}` 落地为本地持久 URL
再给调用者——**上游 URL 有效期极短DashScope 视频仅 24 小时),不落地即丢**。
同类能力对外契约统一i2v 一律 `image_file` 进 → `video` 出;
t2i 出 `image`。模板不用为同一类能力写多套参数名。
**执行机制(已落地,非口头约定)**
- 推理层 `inference.py` 已把 `downloadfile2url`/`b64media2url` 注入模板命名
空间(`_media_ns_extra`request=None 时走部署机 `BASEURL` 兜底拼公网地址)。
- `apply_llm_config` 落库后自动调 `_audit_media_convention` 审计本次涉及的
生成类模板,缺转换函数会返回 `media_audit` 警告,必须如实转告用户。
- 非标协议骨架模板已自带转换占位,人工只需把产物字段名换成文档真实路径。
**核对清单(配每个生成类模型都过一遍)**
1. request 模板含 image/video/audio 上传参数 → 是否有 `b64media2url`
2. response 模板 → 产物 URL 是否经 `downloadfile2url` 落地?
3. 出参字段名是否与同类能力一致video/image
## 提取链路机制2026-09-05 修复)
- `extract_llm_api_spec` 的 LLM 调用走辅助模型链purpose=utility单次