Cliphi Agent API · OpenClaw
Clip videos from any chat app with OpenClaw
Message your OpenClaw agent a video link from WhatsApp or Telegram and get clip links back in the same chat. OpenClaw calls the Cliphi API like any skill and can even run it on a schedule.
Please keep a human in the loop before anything gets published.
How it works in OpenClaw
- 1. Store your Cliphi key with your OpenClaw setup and teach it the two endpoints.
- 2. Send a video link in chat; the agent submits the job and reports progress.
- 3. Receive clips and previews in the conversation; reply to pick what gets posted.
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.