Cliphi Agent API · Make
Clip videos automatically with Make
In Make, the Cliphi API is two HTTP modules in a scenario. New video detected, clips delivered, no code. Add a router afterwards to fan the clips out to review or storage.
Please keep a human in the loop before anything gets published.
How it works in Make
- 1. HTTP module: POST the video URL to /api/v1/jobs with your key.
- 2. Sleep and repeat a GET on the status URL until the job completes.
- 3. Map the clips array into the rest of your scenario.
Start a job
curl -X POST https://www.cliphi.com/api/v1/jobs \
-H "X-API-Key: chp_live_..." \
-H "Content-Type: application/json" \
-d '{"video_url": "https://www.youtube.com/watch?v=VIDEO_ID"}'{
"job_id": "9f2c1b8e-...",
"status": "processing",
"status_url": "/api/v1/jobs/9f2c1b8e-..."
}Poll until done
Jobs run asynchronously and usually finish in a few minutes. The finished job includes rendered clips plus every detected moment with its score, transcript excerpt, and a raw preview URL, so the agent can show its human what else deserves a render.
curl https://www.cliphi.com/api/v1/jobs/9f2c1b8e-... \
-H "X-API-Key: chp_live_..."{
"job_id": "9f2c1b8e-...",
"status": "completed",
"video": { "title": "My podcast ep. 42", "duration_seconds": 3611 },
"clips": [
{
"clip_id": "c_01",
"title": "Why nobody presses the money button",
"url": "https://cdn.cliphi.com/clips/....mp4",
"thumbnail_url": "https://cdn.cliphi.com/thumbs/....jpg",
"aspect_ratio": "9:16",
"viral_score": 92
}
],
"moments": [
{
"moment_id": "m_07",
"title": "The enterprise pricing rant",
"viral_score": 79,
"transcript_excerpt": "and that is why per-seat pricing...",
"preview_url": "https://cdn.cliphi.com/source/....mp4",
"rendered": false
}
]
}Priced per use, in credits
The API spends the same credits as the Cliphi app: processing is billed per video minute and rendering per clip, so an agent pays for exactly what it uses. No seats, no separate API plan.
FAQ
How do I get a key?
Email [email protected] from your Cliphi account email. Keys are tied to your account and its credit balance.
What about supercuts and threads?
Coming to the same endpoint as new formats. Clips shipped first.
Can the agent publish directly?
Publishing through your connected social accounts is on the roadmap. Today the agent gets clip URLs it can post with any tool you already use.