Files
agent/skills/video/SKILL.md
T
kicer 76a0e9ad86 refactor(skill): 参数改为动词作键,去掉 op/name/input_args
形状:{"list":"all"} / {"get":"<名>"} / {"run":"<名>","args":{...}},三者恰好给一个。
- 互斥无法用 required 表达,校验与报错回显放在 toolSkill
- list 取值是字符串范围而非布尔,为将来的技能分类留扩展位;今天只认 all
- list/get 带非空 args 一律报错,不静默丢弃
- 旧形状 {op,name,input_args} 仍由 toolSkill 兜底翻译,只为兼容存量技能文档,不再对外文档化
- README/AGENTS/skills 文档与内置技能调用示例同步为新形态
2026-10-21 09:25:25 +08:00

1.6 KiB
Raw Blame History

name, description, mcp_tool
name description mcp_tool
video AI 生成视频(CogVideo)。op=create 给 prompt(可加 image_url)拿 task_id,op=get 取视频 URL video_task

功能

文生视频 / 图生视频。异步任务语义:提交立即返回 task_id,生成在服务端进行,本技能不内部轮询。

参数

args 原样透传给底层服务:

  • op=create:prompt 与 image_url 至少给一个。
    • 文生视频:只给 prompt(≤512 字符)。
    • 图生视频:再给 image_url——必须是公网可访问的 png / jpeg / jpg、≤5MB。本地图片先用 mint_public_link 签发临时 URL,不要自己拼内网地址。
    • with_audio:可选,是否生成 AI 音频,默认 false。
  • op=get:task_id 必填;SUCCESS 时返回 Video URL(有封面时一并返回)。

用法

  1. 提交

    skill {"run":"video","args":{"op":"create","prompt":"镜头缓慢推进,海浪拍打礁石","with_audio":true}}
    

    → 返回 task_id

  2. 查询

    skill {"run":"video","args":{"op":"get","task_id":"<上一步返回的 id>"}}
    

    → SUCCESS 时返回 Video URL: <url>

注意

  • 生成通常 1~5 分钟。PROCESSING 时不要高频轮询:可以先把其它事做完,再回来查。
  • 结果只有 URL,不落盘;需要本地文件时用 terminal 的 curl -fsSL -o out.mp4 "<url>"。
  • 图生视频的参考图必须公网可达:本地文件先 mint_public_link,再把它返回的地址填进 image_url。
  • 模型名、分辨率、帧率、水印等由服务端配置决定,调用时不需要传。