Cliphi Agent API · ChatGPT
Make short clips from long videos in ChatGPT
Give ChatGPT a video link and get back finished clips. Through a custom action pointed at the Cliphi API, ChatGPT starts the job, checks progress, and lays out the best moments for you to pick from.
Please keep a human in the loop before anything gets published.
How it works in ChatGPT
- 1. Create a custom action with the Cliphi API base URL and your API key header.
- 2. Ask for clips from any public video URL; ChatGPT submits the job and polls the status URL.
- 3. Choose from the rendered clips and previews it shows; ask it to fetch more renders if you want.
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.