9Router 视频生成技能(xAI Grok Imagine)
通过 9Router 统一接口调用 xAI Grok Imagine,以异步任务方式生成、编辑和延长视频,支持文生视频与图生视频。
SKILL.md 明确披露数据流:请求透传至 api.x.ai,密钥经环境变量 NINEROUTER_KEY 注入,明确说明订阅配额是否含视频由 xAI 决定且未经 9Router 验证;无隐蔽外传、无超权限操作,且对可能产生计费的 POST 不自动重试,体现了对用户成本的谨慎。扣分项:无用户确认机制说明、无回滚/取消上传的完整描述、发布者未经注册库验证、依赖外部 setup 文档未随文内嵌。
文档自洽:异步流程(提交→轮询→下载)、connection 头绑定、CLI 的 .part 原子重命名、Ctrl+C 取消、非零退出码、失败状态结构(failed + error code/message)都有描述,失败反馈质量较好。扣分项:纯静态审查,无测试套件或第三方执行证据覆盖该技能关键路径,示例响应为虚构值,边界情况(轮询超时、网络中断)未见处理说明。
触发条件在 description 中清晰(创建/生成/渲染视频、txt2vid、image-to-video),字段表列出必填与可选项,非适配边界部分披露(403 表示无视频权限)。扣分项:依赖 xAI/9Router 及 console.x.ai 等海外服务,对中国大陆网络可达性未评估且核心功能完全依赖境外端点;计费门槛(需 Grok Build OAuth 订阅或 xAI API key)对'适用人群'构成隐含假设,未明确中文支持。
MIT 许可明确,仓库有版本号(0.5.69)、发布工作流和活跃维护信号;文档分层(字段表、示例、Notes & limits)较好,已知限制有披露。扣分项:设置依赖另一个 SKILL.md 的外部 raw 链接而非本地路径,技能本身无独立 changelog/版本对应关系,维护责任仅在仓库层面间接体现。
核心任务(文生视频/图生视频、轮询、下载 MP4)路径描述完整,CLI one-shot 提供直接可用的输出文件,边际价值明确(封装异步轮询细节)。扣分项:未执行验证,实际能否完成取决于用户已有的付费 xAI 订阅/API key 及 9Router 配置,成本与收益证据不足,输出正确性无法静态确认。
字段定义链接到 xAI 官方 API 文档,可交叉核对请求结构;仓库含 CI 工作流和版本发布证据。扣分项:无针对视频技能的测试用例、无已提交的真实执行输出,示例响应均为作者构造,静态证据覆盖薄弱,多数关键声明不可独立复现。
- 视频生成会产生实际计费:需 Grok Build OAuth(SuperGrok/X Premium+ 订阅)或 xAI API key,且订阅是否含视频配额未经 9Router 验证,403 表示账户无视频权限,使用前请确认资费。
- 核心功能完全依赖海外服务(api.x.ai、9Router 端点、console.x.ai),中国大陆网络可达性未经验证,可能需要代理。
- 本评估为静态审查,未执行任何请求;异步轮询超时、网络中断等边界行为未经实测。
- 配置方法托管在另一份外部 SKILL.md 中,若该链接内容变更,本技能文档可能失效。
这个 Skill 能做什么,适合哪些场景?
9router-video 是 9Router 仓库(decolua/9router,MIT 许可)中捆绑的九个技能之一,位于 skills/9router-video/SKILL.md。它封装 9Router 的 /v1/videos/* 接口,底层模型为 xAI 的 grok-imagine-video。视频生成是异步流程:POST 提交后立即返回 request_id,轮询至 done 或 failed,再下载 MP4。使用前提是本地或远程已运行 9Router 服务,并在其仪表盘中连接 xAI 账户(Grok Build OAuth 或 xAI API key,两者计费独立)。它不自动重试创建请求以避免重复扣费,视频任务绑定创建时的连接。
向 POST /v1/videos/generations 提交文生视频或图生视频任务,请求字段包括 prompt、duration、aspect_ratio(16:9、9:16、1:1、4:3、3:4、3:2、2:3)、resolution(480p/720p/1080p)、image(URL 或 base64);向 /v1/videos/edits 和 /v1/videos/extensions 提交视频编辑与延长任务;通过 GET /v1/videos/{request_id} 轮询状态直到 done 或 failed;从 done 响应的 video.url 下载 MP4;也可用 9router xai video CLI 一条命令完成提交、轮询、下载(先写 video.mp4.part,成功后原子重命名)。轮询时需回传 x-connection-id 头。
- 需要为产品或社交媒体生成宣传短片的开发者,输入文字描述即可得到 720p/1080p MP4
- 已有静态图片、想让其动起来的创作者,用 image 字段走图生视频流程
- 需要剪短或续长已有视频的用户,调用 edits/extensions 端点
- 自动化管线中需要程序化生成视频的团队,用 request_id 轮询对接后台任务
- 偏好命令行一键完成的用户,直接用 `9router xai video --prompt ... --output video.mp4`
这个 Skill 有哪些优点和局限?
- 统一走 9Router 接口,请求字段原样透传 xAI,功能完整(生成/编辑/延长)
- 异步任务设计清晰,CLI 一条命令即可提交、轮询、原子下载
- 创建请求绝不自动重试,避免生成并计费两条视频
- 模型标记为 kind: video,不会混入聊天回退链路造成误用
- 必须有已连接的 xAI 账户;Grok 订阅 OAuth 是否含视频配额由 xAI 决定,9Router 不校验,403 即无权限
- 轮询必须回传与创建相同的 x-connection-id,跨连接查询会失败
- 9Router 文档未提供技能本身的自动化测试证据,仓库测试覆盖情况未知
- 仅在 9Router 服务运行时可用,无法独立使用
如何安装这个 Skill?
本技能随 9router 仓库分发:安装服务本身用 npm install -g 9router 然后运行 9router,仪表盘在 http://localhost:20128;或在仓库源码目录 npm install 后 npm run dev。技能文件位于仓库 skills/9router-video/SKILL.md,将其放入你的 Agent Skills 目录即可被兼容客户端发现;仓库未说明各客户端具体的技能安装路径。还需在仪表盘 Providers 中连接 xAI 账户(Grok Build OAuth 或 console.x.ai 的 API key)。
如何使用这个 Skill?
确保环境变量 NINEROUTER_URL(及启用鉴权时的 NINEROUTER_KEY)已设置。对话中触发示例:"帮我生成一段视频:夜晚霓虹城市的电影感跟拍镜头,8 秒,16:9,720p"。手动调用示例:curl -X POST "$NINEROUTER_URL/v1/videos/generations" -H "Authorization: Bearer $NINEROUTER_KEY" -H "Content-Type: application/" -d '{"model":"xai/grok-imagine-video","prompt":"...","duration":8,"aspect_ratio":"16:9","resolution":"720p"}',拿到 request_id 后带 x-connection-id 头轮询 GET /v1/videos/{request_id},done 后下载 video.url。或直接 9router xai video --prompt "..." --output video.mp4。
这个 Skill 与同类方案有什么区别?
直接调用 xAI 官方 API(api.x.ai/v1/videos)是明显替代方案:9Router 的价值在于统一网关、仪表盘账户管理与 CLI 封装;若已有 xAI API key 且不需要网关,官方直连同样可行。