Clipmaster

ClipMaster — video → scored vertical clips

ClipMaster (https://clipmasterapp.com) transcribes a long video, finds the strongest moments with AI, scores each candidate, and renders captioned vertical clips. This skill drives it end-to-end over the public API.

Setup (once)

1. The user needs a ClipMaster account on the Pro or Business plan (API access is plan-gated).
2. Create an API key at https://clipmasterapp.com/api-keys — keys start with cm_, shown once.
3. Expect the key in the CLIPMASTER_API_KEY environment variable. If it is not set, ask the user for it — never guess or hardcode one.
4. Every request: Authorization: Bearer $CLIPMASTER_API_KEY, base URL https://clipmasterapp.com.
5. Jobs need a projectId. Ask the user for one from their dashboard (Projects page). A project pins the playbook / industry overlay / output template so clips match their brand.

All responses use the envelope { "ok": true, "data": ... } or { "ok": false, "error": "..." }.

Workflow: clip a video

1. Create clips (one call does import + transcribe + score)

curl -X POST https://clipmasterapp.com/api/clip \
  -H "Authorization: Bearer $CLIPMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "<project-id>",
    "source": "url",
    "sourceUrl": "https://www.youtube.com/watch?v=...",
    "count": 8,
    "minDurationSec": 15,
    "maxDurationSec": 60
  }'

Fields:

• source: "youtube" or "url" with sourceUrl (YouTube link or direct video URL), or "upload" with a storageKey from a prior in-app upload.
• count: 1–20 clip candidates (default 8).
• minDurationSec 5–120 / maxDurationSec 10–180.
• transcribeOnly: true → returns just the transcript (useful for show notes, chapters, quotes).

The call is synchronous and can take a few minutes for long videos — use a generous HTTP timeout (≥ 10 min). The response's data.clips array contains candidates, each with id, title, startSec, endSec, a virality score, and reasoning explaining why the moment was chosen. Present the top candidates to the user with scores and reasoning.

2. (Optional) Adjust a clip

curl -X PATCH https://clipmasterapp.com/api/clip \
  -H "Authorization: Bearer $CLIPMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"clipId": "<clip-id>", "title": "New hook title", "startSec": 512.4, "endSec": 561.0, "captionPreset": "karaoke"}'

captionPreset: karaoke | word-pop | line | minimal.

3. Export

curl -X PATCH https://clipmasterapp.com/api/clip \
  -H "Authorization: Bearer $CLIPMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"clipId": "<clip-id>", "formats": ["9:16"]}'

Formats: "9:16" (Shorts/Reels/TikTok), "1:1", "16:9". Exports render asynchronously.

4. Poll until ready, then download

curl -H "Authorization: Bearer $CLIPMASTER_API_KEY" \
  "https://clipmasterapp.com/api/clip?clipId=<clip-id>"

Response: data.exports[] with format, status (queued | rendering | ready | failed), and — when ready — a time-limited downloadUrl (valid 1 hour). Poll every 15–30 s. Download promptly once ready.

Choosing a playbook (when creating projects for the user)

Content	playbook id
Podcast / interview	podcasts_interviews
Solo opinion / expert take	talking_head
Webinar / event recording	webinar_event
Tutorial / course	education_training
Product demo / SaaS walkthrough	software_product_demo
Marketing / SEO / AI-search content	marketing_seo_geo
Gaming footage	gaming_gameplay
Livestream VOD	livestream_vod

Errors & limits

• 401 — missing/invalid/revoked key. Ask the user to check CLIPMASTER_API_KEY.
• 402 — insufficient credits. Tell the user to top up at https://clipmasterapp.com/pricing.
• 403 — key valid but plan lacks API access (needs Pro or Business).
• 422 — import/transcription failed (bad URL, private video, unsupported source). Report the error message verbatim.
• 429 — rate limit (20 clip jobs/hour). Wait and retry; don't hammer.
• Never loop retries on 4xx other than 429. Clip jobs spend the user's credits — confirm before batch-processing many videos.

Rights reminder

Only clip videos the user owns or has permission to repurpose. If asked to clip someone else's content, remind the user they need the creator's permission.