opusclip
2
总安装量
1
周安装量
#74839
全站排名
安装命令
npx skills add https://github.com/opus-pro/opus-skills --skill opusclip
Agent 安装分布
amp
1
cline
1
opencode
1
cursor
1
kimi-cli
1
codex
1
Skill 文档
OpusClip
Turn long-form videos into short clips via the OpusClip API.
Prerequisites
OPUSCLIP_API_KEYmust be set. Get it from https://clip.opus.pro/dashboard- The CLI at
scripts/opuscliprequirescurlandjq
CLI Quick Reference
Run the bundled CLI at scripts/opusclip. All commands output JSON.
opusclip create-project --url URL [options] Create clips from a video URL
opusclip get-clips --project ID [--summary] Get exportable clips
opusclip preview --project ID [--output PATH] Generate HTML preview and open in browser
opusclip share-project --project ID Set visibility (PUBLIC/DEFAULT)
opusclip templates List brand templates
opusclip upload --file PATH [options] Upload local video + create project
opusclip collections <sub> [options] Manage collections
opusclip censor <sub> [options] Censor profanity in clips
create-project
opusclip create-project --url "https://youtube.com/watch?v=..." [options]
| Flag | Description |
|---|---|
--url |
(required) Video URL |
--model |
ClipBasic (talking-head) or ClipAnything (diverse) |
--prompt |
Custom clipping prompt (ClipAnything only) |
--keywords |
Comma-separated topic keywords (ClipBasic only) |
--aspect |
portrait (default), landscape, square |
--durations |
Target clip lengths in seconds, e.g. "30,60" |
--range-start / --range-end |
Clip only a portion (seconds) |
--template |
Brand template ID |
--genre |
Video genre hint |
--lang |
Source language code |
--title |
Video title metadata |
--webhook |
Webhook URL for completion notification |
--skip-curate |
Process original video without AI curation |
--remove-filler |
Remove filler words |
upload
Same flags as create-project plus --file PATH. Handles the full 4-step GCS upload flow automatically.
get-clips
opusclip get-clips --project PROJECT_ID
opusclip get-clips --project PROJECT_ID --summary
opusclip get-clips --collection COLLECTION_ID
| Flag | Description |
|---|---|
--project |
Project ID to fetch clips for |
--collection |
Collection ID to fetch clips for |
--summary |
Output condensed JSON with title, description, hashtags, scores, duration, and preview/export URLs (instead of full raw response) |
When presenting clips to the user, always use --summary to get human-readable fields (title, description, hashtags, scores). Display clips with their title and description rather than just clip IDs.
preview
Generate an HTML preview page with video players for all clips and open it in the browser.
opusclip preview --project PROJECT_ID
opusclip preview --project PROJECT_ID --output /path/to/output.html
opusclip preview --collection COLLECTION_ID
| Flag | Description |
|---|---|
--project |
Project ID |
--collection |
Collection ID |
--output |
Custom output path (default: /tmp/opusclip-preview-{id}.html) |
The preview page shows clips sorted by score with inline video players, titles, descriptions, hashtags, and detailed AI scores (hook, coherence, connection, trend). Use this whenever the user wants to watch or preview their clips.
collections
opusclip collections list
opusclip collections create --name "NAME"
opusclip collections delete --id ID
opusclip collections export --id ID
opusclip collections add-clip --id COL_ID --content-id PROJECT_ID.CLIP_ID
opusclip collections remove-clip --id COL_ID --content-id PROJECT_ID.CLIP_ID
censor
opusclip censor create --project PID --clip CID [--beep]
opusclip censor status --job JOB_ID
Statuses: QUEUED â PROCESSING â CONCLUDED / FAILED
Common Workflows
Clip a YouTube video
opusclip create-project --url "https://youtube.com/watch?v=VIDEO_ID"
# Wait for processing, then:
opusclip get-clips --project PROJECT_ID --summary
# Preview clips in browser:
opusclip preview --project PROJECT_ID
Use ClipAnything with a custom prompt
opusclip create-project \
--url "https://youtube.com/watch?v=VIDEO_ID" \
--model ClipAnything \
--prompt "Find the most emotional moments" \
--durations "30,60,90"
Upload a local video, clip, and organize
opusclip upload --file video.mp4 --title "Interview" --model ClipBasic
opusclip get-clips --project PROJECT_ID
opusclip collections create --name "Best Clips"
opusclip collections add-clip --id COL_ID --content-id PROJECT_ID.CLIP_ID
opusclip collections export --id COL_ID
Constraints
- Rate limit: 30 req/min
- Max video: 10 hours, 30 GB
- Max concurrent: 50 projects
- Projects expire after 30 days
- 1 credit = 1 minute of video
API Reference
For detailed endpoint schemas, parameters, and response formats, see references/api-reference.md.