Cliphi Agent API · n8n
Video to clips in an n8n workflow
Two HTTP Request nodes are the whole integration: one submits the video, one polls the job. Feed it from an RSS trigger or a form, and route the finished clips anywhere n8n can reach.
Please keep a human in the loop before anything gets published.
How it works in n8n
- 1. Node 1: POST /api/v1/jobs with the video URL and your key header.
- 2. Node 2: poll GET /api/v1/jobs/{id} on a wait loop until status is completed.
- 3. Branch on the clips array: save to storage, notify a channel, or queue for posting.
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.