ClipmivoAI

ClipmivoAI 开发者工具

通过 ClipmivoAI API、CLI、本地 MCP 服务或 Agent Skill 创建 AI 视频。所有客户端都使用 **https://clipmivoai.com/api/v1**、作用域受限的 API 密钥和你的 ClipmivoAI 账户余额。

English · 简体中文 · 网站 · API 指南 · OpenAPI

选择你的接口

接口	从这里开始
REST API	身份验证、报价和任务提交
CLI	安装和使用 CLI
MCP	连接本地 stdio 服务
Agent Skill	clipmivo-video

登录 ClipmivoAI，在 API / CLI（开发者）工作区创建作用域受限的密钥，并通过网站添加点数。读取操作需要 video:read，报价和生成需要 video:write，媒体上传需要 files:write。API 请求会创建视频任务；它们不会购买点数充值。

安装

需要 Node.js 22+ 和 npm。已发布的下载文件托管在 GitHub Releases；这些命令不依赖 npm registry 中的包：

npm install -g https://github.com/BarneyD66/clipmivo-tools/releases/download/v0.1.1/clipmivo-cli-0.2.7.tgz
npm install -g https://github.com/BarneyD66/clipmivo-tools/releases/download/v0.1.1/clipmivo-mcp-0.1.8.tgz
clipmivo --version
clipmivo-mcp --version

使用 shell 或密钥管理器设置 CLIPMIVO_API_KEY。切勿将真实密钥放入此代码库。开发时：

git clone https://github.com/BarneyD66/clipmivo-tools.git
cd clipmivo-tools
npm ci
npm test
node cli/bin/clipmivo.mjs models --json

第一个视频

clipmivo models --json
clipmivo balance --json
clipmivo quote --file examples/request.json --json

检查当前报价并确认你的支出上限。参照 CLI 报价确认示例，将 quoted_credits 添加到单独的请求文件中，然后提交：

clipmivo generate --file quoted-request.json --idempotency-key my-first-shot-001 --wait --timeout 600 --json
clipmivo get TASK_ID --json
clipmivo download TASK_ID --output result.mp4 --json

如果提交结果不确定，请继续使用相同的已确认请求和幂等键。等待超时不代表视频生成失败；请继续查询状态，而不是创建另一个任务。模型选项和价格可能变化：请使用实时模型发现和报价。

点数计费和你的应用

直接将 credits_to_hold 显示为点数；不要将 API 点数报价乘以 100。生成前会预留点数，之后会在适用情况下根据实际用量结算。未使用的预留点数会退回余额。参考换算比例为 100 点数 = 1 美元；充值需通过网站单独购买。

对于面向客户的应用，请将 ClipmivoAI 密钥保存在你的服务器上。同一账户下的密钥共用该账户的余额和账户级资源；它们不是相互隔离的转售子账户。请参阅应用集成。

MCP

配置支持本地 stdio MCP 的客户端：

{
  "mcpServers": {
    "clipmivo": {
      "command": "clipmivo-mcp",
      "env": {
        "CLIPMIVO_API_KEY": "YOUR_SCOPED_API_KEY",
        "CLIPMIVO_FILES_DIR": "/absolute/path/to/video-files"
      }
    }
  }
}

将真实密钥保存在客户端的密钥设置中。Windows 用户请使用 C:/Users/you/Videos/Clipmivo 等现有目录；如果客户端无法解析命令 shim，请参阅 MCP 指南。这是本地服务，并非托管的 MCP OAuth 端点。

Skill

将 skills/clipmivo-video 复制到你的 Agent 支持的 Skill 目录中。对于 Codex，请使用 ~/.codex/skills/clipmivo-video。重启或重新加载 Skills，然后提出请求：

使用 $clipmivo-video 创建一段池塘中纸船的视频。生成支出上限：25 点数。

该 Skill 可以使用已安装的 MCP 或 CLI。它会保留现有预算授权，并要求在付费提交前提供有效报价。安装该 Skill 不会创建 API 密钥，也不会授予点数。

支持

请通过 GitHub issues 报告可复现的客户端错误，且不要附上凭据或私人媒体。账户、付款和账单问题：[email protected]。服务使用仍受网站条款和隐私政策约束。

此代码库包含公开的客户端工具和文档，不包含网站后端。