47 lines
2.6 KiB
Markdown
47 lines
2.6 KiB
Markdown
# Agnes 视频协议（当前不可用）
|
||
|
||
Agnes 作为内置占位插件保留，是为了让历史模型配置能显示明确的不可用原因，而不是静默消失。当前仓库没有可验证的官方接口、鉴权、模型、轮询和响应资料，因此插件被强制禁用，也不可安装或选择。
|
||
|
||
## 接口与当前状态
|
||
|
||
{{OPERATIONS}}
|
||
|
||
创建、轮询、取消路径均为空。调用 `BuildCreate` 会返回 `UnavailableError`：`未提供可验证的官方请求、鉴权、轮询和响应协议资料`。页面展示该条目不代表可以发送任务。
|
||
|
||
## 模型与能力状态
|
||
|
||
当前没有任何经过验证的模型 ID、能力范围或计费规则。任何 Agnes 模型名都不可提交；只有取得官方模型目录并完成真实账户验证后，才能写入渠道模型配置。
|
||
|
||
## 参数与字段状态
|
||
|
||
当前 metadata 没有参数映射，创建请求也不存在。`model`、`prompt`、参考素材、时长、比例、分辨率、音频和水印均不得推测或透传。
|
||
|
||
## 启用前必须补齐的事实
|
||
|
||
| 项目 | 必须取得的证据 | 验收方式 |
|
||
| --- | --- | --- |
|
||
| 服务入口 | 官方 Base URL、版本、区域 | 官方文档链接和最小健康探测 |
|
||
| 鉴权 | Header、Token/签名算法、权限范围 | 不在 URL/日志泄露密钥的集成测试 |
|
||
| 模型 | 精确模型 ID、能力和停用策略 | 真实账户模型发现或官方表 |
|
||
| 创建 | Method、Path、Content-Type、完整字段 | 请求 fixture 与真实 2xx 响应 |
|
||
| 轮询 | 任务 ID、状态枚举、失败结构 | queued -> running -> completed/failed fixture |
|
||
| 结果 | 视频 URL、文件接口、有效期 | 下载并存入影策资源的冒烟测试 |
|
||
| 取消与账务 | 是否支持取消、失败退款语义 | 官方合同与错误场景验证 |
|
||
|
||
## 禁止的临时处理
|
||
|
||
- 不得根据插件名猜测 `/v1/videos`、模型名或 Bearer 鉴权。
|
||
- 不得复用其他视频供应商的字段并把 200 响应当兼容。
|
||
- 不得用空任务 ID、默认成功状态或假 URL 让页面“看起来能用”。
|
||
- 不得仅在前端隐藏；后端 registry 和写路径必须继续拒绝不可用协议。
|
||
|
||
## 未来实现结构
|
||
|
||
取得官方资料后，应新增独立 adapter、专属 create/poll/result fixture、错误码映射和一份替换本文的完整文档。若协议实际是已有供应商的别名，应迁移历史配置到明确的 canonical ID，而不是永久保留第二套执行逻辑。
|
||
|
||
## 官方资料
|
||
|
||
当前未找到可验证且与本插件对应的官方开发者资料。为避免误导，本页不引用搜索聚合、论坛转述或其他同名产品文档。
|
||
|
||
{{CONTRACT}}
|