设计与前端 text-to-videoimage-to-videoxai-grok-imagine9routervideo-generationasync-job-pollingrest-api

9Router 视频生成技能(xAI Grok Imagine)

通过 9Router 统一接口调用 xAI Grok Imagine,以异步任务方式生成、编辑和延长视频,支持文生视频与图生视频。

FollowSkills 评估 · FSRS-2.0
谨慎使用
49/ 100 五分制 2.5 / 5
1 2 3 4 5 6
1信任安全14 / 25 · 2.8/5

SKILL.md 明确披露数据流:请求透传至 api.x.ai,密钥经环境变量 NINEROUTER_KEY 注入,明确说明订阅配额是否含视频由 xAI 决定且未经 9Router 验证;无隐蔽外传、无超权限操作,且对可能产生计费的 POST 不自动重试,体现了对用户成本的谨慎。扣分项:无用户确认机制说明、无回滚/取消上传的完整描述、发布者未经注册库验证、依赖外部 setup 文档未随文内嵌。

2可靠稳定9 / 20 · 2.3/5

文档自洽:异步流程(提交→轮询→下载)、connection 头绑定、CLI 的 .part 原子重命名、Ctrl+C 取消、非零退出码、失败状态结构(failed + error code/message)都有描述,失败反馈质量较好。扣分项:纯静态审查,无测试套件或第三方执行证据覆盖该技能关键路径,示例响应为虚构值,边界情况(轮询超时、网络中断)未见处理说明。

3适用触发8 / 15 · 2.7/5

触发条件在 description 中清晰(创建/生成/渲染视频、txt2vid、image-to-video),字段表列出必填与可选项,非适配边界部分披露(403 表示无视频权限)。扣分项:依赖 xAI/9Router 及 console.x.ai 等海外服务,对中国大陆网络可达性未评估且核心功能完全依赖境外端点;计费门槛(需 Grok Build OAuth 订阅或 xAI API key)对'适用人群'构成隐含假设,未明确中文支持。

4规范维护8 / 15 · 2.7/5

MIT 许可明确,仓库有版本号(0.5.69)、发布工作流和活跃维护信号;文档分层(字段表、示例、Notes & limits)较好,已知限制有披露。扣分项:设置依赖另一个 SKILL.md 的外部 raw 链接而非本地路径,技能本身无独立 changelog/版本对应关系,维护责任仅在仓库层面间接体现。

5有效结果6 / 15 · 2.0/5

核心任务(文生视频/图生视频、轮询、下载 MP4)路径描述完整,CLI one-shot 提供直接可用的输出文件,边际价值明确(封装异步轮询细节)。扣分项:未执行验证,实际能否完成取决于用户已有的付费 xAI 订阅/API key 及 9Router 配置,成本与收益证据不足,输出正确性无法静态确认。

6证据核验4 / 10 · 2.0/5

字段定义链接到 xAI 官方 API 文档,可交叉核对请求结构;仓库含 CI 工作流和版本发布证据。扣分项:无针对视频技能的测试用例、无已提交的真实执行输出,示例响应均为作者构造,静态证据覆盖薄弱,多数关键声明不可独立复现。

证据充分度: 评估于 2026年9月9日 审查版本 eb712ca821f0
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 视频生成会产生实际计费:需 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 头。

  1. 需要为产品或社交媒体生成宣传短片的开发者,输入文字描述即可得到 720p/1080p MP4
  2. 已有静态图片、想让其动起来的创作者,用 image 字段走图生视频流程
  3. 需要剪短或续长已有视频的用户,调用 edits/extensions 端点
  4. 自动化管线中需要程序化生成视频的团队,用 request_id 轮询对接后台任务
  5. 偏好命令行一键完成的用户,直接用 `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 installnpm 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 且不需要网关,官方直连同样可行。

常见问题

使用这个技能要花钱吗?
9Router 软件本身免费且不收费;实际费用由 xAI 侧决定——API key 按 xAI 计费,Grok Build 订阅 OAuth 的视频配额是否包含取决于订阅等级,由 xAI 控制,403/permission_denied 表示该账户无视频权限。
为什么轮询拿不到任务结果?
任务是账户绑定的:必须用创建任务时返回的 x-9router-connection-id 值,作为 x-connection-id 头回传,才能在同一账户下轮询。
任务失败会自动重试吗?
不会。创建类 POST 绝不自动重试,否则可能生成并计费两条视频;仅有 401 时刷新令牌并单次重试(此场景上游会在建任务前拒绝)。
支持哪些画面参数?
aspect_ratio 支持 16:9、9:16、1:1、4:3、3:4、3:2、2:3;resolution 支持 480p、720p、1080p;duration 为秒数,均为可选字段,prompt 在文生视频时必填。

同仓库的其他 Skills

均来自 decolua/9router

开发与工程

9Router 文字转语音(9Router TTS)

通过 9Router 统一的 /v1/audio/speech 接口,用 OpenAI、ElevenLabs、Edge TTS、Deepgram 等十余家语音供应商把文本转成 MP3 语音。

开发与工程

9Router 图像生成技能

通过 9Router 统一端点调用 OpenAI、Gemini、FLUX、Stability 等 40+ 提供商的文生图模型,让 AI 编程助手可以直接生成图片。

开发与工程

9Router 语音转文字技能

通过 9Router 的 /v1/audio/transcriptions 接口,用一套统一调用访问 Whisper、Groq、Gemini、Deepgram 等多种语音转写模型。

开发与工程

9Router 网页抓取技能

通过 9Router 的 /v1/web/fetch 接口,把任意 URL 一键转为 Markdown、纯文本或 HTML,自动在 Jina Reader、Firecrawl、Tavily、Exa、Ollama Cloud 等抓取后端间选择与回退。

开发与工程

9Router 嵌入生成技能

通过本地 9Router 的 /v1/embeddings 端点,调用 OpenAI、Gemini、Mistral、Voyage、Nvidia、GitHub 等嵌入模型,为 RAG、语义搜索和相似度计算生成向量。

开发与工程

9Router 网页搜索技能

通过 9Router 的 /v1/search 接口聚合 Tavily、Exa、Brave 等 11 家搜索源,让 AI 编程助手直接联网搜索网页和 X 帖子。

开发与工程

9Router Chat 技能

通过 9Router 网关调用任意大模型,支持 OpenAI 与 Anthropic 两种 API 格式、流式输出和组合自动回退,让对话与代码生成不再受单家配额限制。

开发与工程

9Router 网关接入技能

让 AI 编码工具通过本地网关统一调用 40+ 免费与低价模型供应商,自动故障切换,配合 RTK 每次请求节省 20-40% 的 token。

相关 Skills