MG-04-013 渠道接入
新渠道使用编译进服务的 Go 原生适配器;可选协议来自 GET /admin/v1/adapters。动态 JS 安装和绑定入口已关闭,仅保留历史任务执行。管理员使用 Skill 即可,无需 MCP。
MG-CHANNEL-01 管理视频渠道接入;MG-RESTORE-01 按用户确认恢复模型编排和人工优先级选路,不增加销售或收费生成行为。现有管理 API 认证继续生效。
网页流程
视频渠道 → 新建(王牌 / ArtBox / AI 造梦 / MetaJing / Omega / StarFrame-XZAPI / OpenAI 视频兼容)→ 保存渠道 → 轮换凭据表单录入 Key → 测试连接 → 渠道详情“上游模型接入”。
拉取最新模型与价格 → 按视频/类型待确认/上游未返回/全部分类筛选 → 选择型号 → 确认协议和导入 → 配置参数及采购价格资料。 已知的上游 duration、resolution、aspect_ratio、prompt 字段自动转为未验证参数;没有文档的字段保持未知。不能从型号后缀猜测能力。 拉取和导入不提交生成任务;导入为停用草稿、不发布路由。旧参数和价格不会因同步丢失。
新增 API
Base /admin/v1,Bearer 管理 Key。
| API | 作用 |
|---|---|
| GET /channels/{id}/models | 读取最新模型/价格快照与已配置型号,返回 channel、snapshot_id、更新时间、protocols、models、warnings |
| POST /channels/{id}/models/sync | 顺序刷新模型和价格。模型失败返回错误;价格失败保留模型结果并返回明确 warning |
| POST /channels/{id}/models/import | If-Match=channel.version;body 为 snapshot_id、items。只导入当前快照所选视频型号 |
| PUT /supplies/{id}/procurement-terms | If-Match=supply.version;保存有来源的采购报价资料到 metadata.upstream_pricing,保留其他元数据 |
导入 item:model_id, request_profile, adapter_profile, variant_key, confirm_video, supply_family?;协议使用 models API 返回的候选,最多 100 项。supply_family 为可选渠道内分组名(最多 120 bytes),不同 variant_key 可为同一上游型号建立独立规格。重导入不覆盖既有分组。
每项独立持久化,结果 imported/existing/parameters_pending/conflict/failed。存在相同型号+协议+规格时不覆盖。
parameters_pending 表示型号已导入但参数仍需手动确认,不能当作事务全失败后另建同名型号。
类型明确为非视频时,即使 confirm_video=true 也拒绝;类型未提供才允许显式确认。
model.change 和 price_change 表示相对上次上游观察的变化,不表示已经覆盖了本地配置。
报价资料字段:billing_mode(per_request/per_second/per_token/table)、unit、amount、cny_per_unit、min_seconds、max_seconds、reference_amount、official_ratio、reference、notes、observed_at。 数值使用十进制字符串,时间为 RFC3339。未知数字留空,区间留 null。例如 3 元/条(4–15 秒)、50 影币/秒且每币 0.008 元、官方 Token 价的 0.6 倍分别独立记录。 报价资料不是执行成本规则:这一轮不改调度/计价内核,原 cost-rules 保留原样;Token 报价记录不代表已实现 Token 结算或模型已可启用。 采购资料更新递增 Supply.version、保留审计中的前后配置;无需数据库迁移。
管理员电脑的独立 Skill(推荐)
安装 skills/oceanway-channel-onboarding,使用其中 scripts/gateway.py 直接调用管理 API,仅依赖 Python 3 标准库,不需要配置 MCP。
本机连接配置仅存网关地址、密钥文件路径与写入开关,详见技能的 references/direct-api.md。密钥不随技能分发;每次写操作仍需管理员授权、--confirm 和适用资源的最新版本。
Skill 发布源在 skills/oceanway-channel-onboarding/SKILL.md,由管理员安装到自己的客户端技能目录;本任务不自动修改全局客户端配置。
已知边界与验证
- 当前服务沿用单管理 Key;独立管理员身份、权限范围和逐人撤销是 MG-OPS-01,尚未实现,不能直接作为多管理员公网开放的授权方案。
- ArtBox/造梦等未提供完整动态参数时,仍需核对文档填写;兼容协议不保证所有上游型号支持生成。
- 本轮未部署、未用真实 Key、未生成收费视频。隔离 PostgreSQL、SDK 客户端及网页测试不能替代真实上游验收。
- 复用 new-api 的渠道父子、发现/配置对比与参数维护业务逻辑;未复制 AGPL 源码。参考仓库 commit 6484b5971ccb6c9c76ed78b6dfa2fe338bd992b0 的 controller/video_supply_route.go、model/video_supply_catalog.go、web/default/src/features/video-supply-routes/。