Go Motion
章节Agent 技能

Claude Code、Codex 与 Cursor 的 Agent 技能

开源的 Go Motion 技能让你的编程助手替你做视频：它写脚本，你在对话里确认，Go Motion 生成旁白、字幕和画面，再把 MP4 渲染到你的项目文件夹。同一个账号、同样的积分，每个付费步骤都先确认。

  • Claude Code · Codex · Cursor
  • 与工作台同价
  • 开源，MIT 协议
本页内容
  1. 技能能做什么
  2. 开始之前
  3. 安装技能
  4. 配置 API 密钥
  5. 第一个视频
  6. 费用
  7. 给开发者：技能背后的接口
  8. 在工作台继续
  9. 遇到问题
  10. 常见问题

技能能做什么

技能是一个很小的开源包，供编程助手阅读：一份写明流程的 SKILL.md，加一个零依赖脚本，用你自己的 API 密钥调用 Go Motion 接口。你在对话里描述视频，助手创建草稿、在每个付费步骤前征求你的同意、把脚本拿给你看，最后把 MP4 和字幕文件放进项目文件夹。

助手用你的账号驱动与工作台相同的流水线；生产在 Go Motion 的服务器上完成。

一切都按工作台同样的积分和价格计费，而且没有你的同意什么都不会跑：助手必须带上你接受的积分上限，接口才会执行付费步骤。生产之后的修改，比如换图或改字幕样式，仍在工作台里完成。

开始之前

  • 一个有积分的 Go Motion 账号。新账号自带免费积分；积分包见定价页。
  • 在设置 → API 密钥创建的密钥。密钥等同于你的账号权限，不要贴进对话或仓库，泄露了就在同一页删除。
  • 电脑上装有 Node.js 18 或更新版本，以及 Claude Code、Codex、Cursor 之一。
  • 一两句话的主题，或一份你写好的脚本。

安装技能

  1. 1

    一条命令安装

    在要产出视频的项目目录里运行。加 -g 可全局可用，加 -a claude-code、-a codex 或 -a cursor 指定助手。

  2. 2

    或者手动克隆

    技能就是一个带 SKILL.md 的文件夹，放到助手查找技能的位置即可：Claude Code 为 ~/.claude/skills/gomotion，Codex 为 ~/.agents/skills/gomotion，Cursor 为 ~/.cursor/skills/gomotion。

  3. 3

    确认装好了

    在 Claude Code 里输入 /gomotion，在 Codex 里输入 $gomotion，助手会列出这个技能和它的说明。

bash
npx skills add gomotionai/gomotion-skill

# 或手动克隆（Claude Code）
git clone https://github.com/gomotionai/gomotion-skill ~/.claude/skills/gomotion
源码：github.com/gomotionai/gomotion-skill，短链 gomotion-ai.app/skill 指向同一页面。

配置 API 密钥

  1. 1

    创建密钥

    打开设置 → API 密钥，点击创建密钥，用这台电脑的名字命名，然后复制。

  2. 2

    写进 shell

    把下面这行加到 ~/.zshrc 或 ~/.bashrc，再开一个新终端，之后每次助手会话都能读到。

  3. 3

    试一下

    让助手查一下你的 Go Motion 余额。它会运行技能的 me 命令并报出积分。

bash
export GOMOTION_API_KEY=sk_your_key_here

第一个视频

像给撰稿人写需求一样说清楚：开头的钩子、要讲的事实、目标观众、语气、时长和画幅。之后助手每次询问时确认即可。

  1. 1

    描述视频

    例如：做一个 60 秒的 16:9 科普视频，讲章鱼为什么有三颗心脏，语气好奇又友好，面向科学频道。 助手会免费创建草稿，并给出写脚本的价格。

  2. 2

    镜头确认

    写脚本每分钟 10 积分。你说好，大约一分钟后助手就把各个镜头的旁白拿给你看。用自然语言提修改即可，改稿免费。

  3. 3

    生产

    生产会录制旁白、对齐字幕并为每个镜头找画面：每分钟 30 积分，先确认再跑。一分钟的视频大约需要几分钟。

  4. 4

    导出

    1080p MP4 每分钟 5 积分。助手会等渲染完成，把 MP4 连同 SRT、VTT 字幕下载到项目里的 gomotion 文件夹。

  5. 5

    在工作台继续打磨

    助手的汇报最后会附上这个系列在工作台的链接，你可以在那里换图、改字幕样式、重录某一句或制作缩略图。

费用

操作价格
写脚本每分钟 10 积分
生产旁白、字幕和画面每分钟 30 积分
导出 1080p MP4每分钟 5 积分
草稿、改稿、查状态和下载免费
失败的步骤积分退回

给开发者：技能背后的接口

技能只是公开接口的一个薄客户端。每次调用都以 Bearer 方式携带你的密钥。每个付费端点要么带 dryRun: true 只取报价，要么带 maxCredits（你接受的积分上限）：服务端在同一个请求里报价、扣费并启动任务；价格高于上限时返回 409 QUOTE_EXCEEDS_BUDGET，余额不足时返回 402 INSUFFICIENT_CREDITS。

方法路径作用
GET/api/v1/me余额、限制和常用链接
POST/api/v1/videos由 idea 或自己的 scenes 建草稿（免费）
POST/api/v1/videos/:id/plan写脚本
PATCH/api/v1/videos/:id/scenes替换镜头脚本（免费）
POST/api/v1/videos/:id/produce旁白、字幕和画面
POST/api/v1/videos/:id/export渲染 1080p MP4
GET/api/v1/videos/:id状态：planning、review、producing、ready、exporting、exported 或 failed
GET/api/v1/jobs/:id/downloadMP4（短期有效的签名链接）
GET/api/v1/jobs/:id/subtitles?format=srtSRT 或 VTT 字幕
bash
curl -H "Authorization: Bearer $GOMOTION_API_KEY" https://gomotion-ai.app/api/v1/me

完整参考（每个字段和错误码）在技能仓库的 references/api.md。

在工作台继续

助手做出的视频就是你账号里的一个普通系列。从助手汇报里的链接或工作台打开它，像其他视频一样编辑：见编辑视频和缩略图。

遇到问题

  • 密钥缺失或被拒（401）。 在设置 → API 密钥创建密钥，写进 GOMOTION_API_KEY，再开一个新终端。
  • 积分不足（402）。 助手会说明这一步需要多少积分；到定价页买一个积分包，然后告诉它。
  • 价格高于你允许的额度（`QUOTE_EXCEEDS_BUDGET`）。 视频越长越贵；确认新的额度，助手会重试。
  • 某一步失败了。 积分会自动退回；让助手再试一次即可。
  • Codex 提示网络被禁止。 Codex 的沙箱默认禁网：在审批里允许该命令在沙箱外运行，或用 -c 'sandbox_workspace_write.network_access=true' 启动 Codex。
  • 想在生产后修改视频。 到工作台里改；技能只负责创建、生产和导出。

常见问题

需要付费订阅吗？

不需要订阅，只需要积分。新账号有免费积分可以试用；之后到定价页买积分包。技能花费不会超过你为每一步确认的额度。

支持哪些助手？

Claude Code、Codex 和 Cursor 读取同一个技能文件夹。任何遵循开放 agent skills 格式、能运行 Node.js 脚本的助手都可以。

文件保存在哪里？

在你当前项目的 gomotion 文件夹里：MP4 以及 SRT、VTT 字幕。

可以做其他语言的视频吗？

可以，与工作台支持的语言一致；告诉助手语言，它会选好配音。见创建系列。

我的密钥安全吗？

把它当密码对待：技能从不打印它，你随时可以在 API 密钥页删除。