clipmivo-tools
ClipmivoAI video generation tools: REST API, CLI, local MCP server and Agent Skill.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/barneyd66--clipmivo-tools)HTML
<a href="/listings/barneyd66--clipmivo-tools"><img src="/api/listings/barneyd66--clipmivo-tools/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Requires Node.js 22+ and npm. Published downloads are hosted in GitHub Releases; these commands do not depend on an npm registry listing:
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
Set `CLIPMIVO_API_KEY` using your shell or secret manager. Never put a real key into this repository. For development:
git clone https://github.com/BarneyD66/clipmivo-tools.git cd clipmivo-tools npm ci npm test node cli/bin/clipmivo.mjs models --json
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 95 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # ClipmivoAI developer tools
- Create AI videos through the ClipmivoAI API, CLI, local MCP server or agent Skill. All clients use **https://clipmivoai.com/api/v1**, your scoped API key and your ClipmivoAI account balance.
- English · [简体中文](docs/README.zh-CN.md) · [Website](https://clipmivoai.com) · [API guide](docs/API.md) · [OpenAPI](docs/openapi.json)
- ## Choose your interface
- | Interface | Start here |
- | --- | --- |
- | REST API | [Authentication, quotes and task submission](docs/API.md) |
- | CLI | [Install and use the CLI](cli/README.md) |
- | MCP | [Connect a local stdio server](mcp/README.md) |
- | Agent Skill | [clipmivo-video](skills/clipmivo-video/SKILL.md) |
- Sign in at [ClipmivoAI](https://clipmivoai.com/?section=api), create a scoped key in the API / CLI (Developer) workspace and add credits through the website. Read operations require `video:read`, quotes and generation require `video:write`, and media uploads require `files:write`. API requests create video tasks; they do not purchase credit top-ups.
- ## Install
- Requires Node.js 22+ and npm. Published downloads are hosted in GitHub Releases; these commands do not depend on an npm registry listing:
- ```sh
- 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
- ```
- Set `CLIPMIVO_API_KEY` using your shell or secret manager. Never put a real key into this repository. For development:
- ```sh
- git clone https://github.com/BarneyD66/clipmivo-tools.git
- cd clipmivo-tools
- npm ci
- npm test
- node cli/bin/clipmivo.mjs models --json
- ```
- ## First video
- ```sh
- clipmivo models --json
- clipmivo balance --json
- clipmivo quote --file examples/request.json --json
- ```
- Review the current quote and confirm your spending limit. Follow the [CLI quote confirmation example](cli/README.md#confirm-a-quote-before-submission) to add `quoted_credits` to a separate request file, then submit:
- ```sh
- 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
- ```
- Keep the same confirmed request and idempotency key after an uncertain submission. A wait timeout is not a failed video; resume status queries instead of creating another task. Model options and prices can change: use live model discovery and quotes.
- ## Credit billing and your application
- Show `credits_to_hold` directly as Credits; do not multiply an API credit quote by 100. Credits are reserved before generation, then settled using actual usage where applicable. Unused reserved credits return to the balance. The reference conversion is 100 Credits = US$1; top-ups are purchased separately on the website.
- For a customer-facing app, keep the ClipmivoAI key on your server. Keys on one account share its balance and account-level resources; they are not isolated reseller subaccounts. See [application integration](docs/APPLICATIONS.md).
- ## MCP
- Configure a client that supports local stdio MCP:
- ```json
- {
- "mcpServers": {
- "clipmivo": {
- "command": "clipmivo-mcp",
- "env": {
- "CLIPMIVO_API_KEY": "YOUR_SCOPED_API_KEY",
- "CLIPMIVO_FILES_DIR": "/absolute/path/to/video-files"
- }
- }
- }
- }
- ```
- Store the real key in your client's secret settings. On Windows use an existing directory such as `C:/Users/you/Videos/Clipmivo`; see the [MCP guide](mcp/README.md) if your client cannot resolve command shims. This is a local server, not a hosted MCP OAuth endpoint.
- ## Skill
- Copy `skills/clipmivo-video` into the skill directory supported by your agent. For Codex, use `~/.codex/skills/clipmivo-video`. Restart or reload skills, then ask:
- > Use $clipmivo-video to create a video of a paper boat on a pond. Maximum generation spend: 25 Credits.
- The Skill can use the installed MCP or CLI. It preserves existing budget authorization and requires a valid quote before paid submission. Installing the Skill does not create an API key or grant credits.
- ## Support
- Use GitHub issues for reproducible client bugs without credentials or private media. Account, payment and billing questions: **contact@clipmivoai.com**. Service use remains subject to the website's terms and privacy policy.
- This repository contains public client tools and documentation, not the website backend.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.