AI clipping API: one request in, clips out
Your first video free up to 60 minutes, then 20 free minutes a month, no credit card.
Send a video link to POST /api/process, get vertical clips with captions back. One request
starts the job, a webhook or GET /api/status/<job_id> tells you when it is done, and every clip comes with a signed
download link. API jobs use the same minutes as the app.
Start a job
curl -X POST https://aiclipmaker.org/api/process \
-H "Authorization: Bearer acm_..." \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=...", "acknowledged": true,
"target_clips": 5, "webhook_url": "https://example.com/hook", "webhook_secret": "..."}'
The answer is {"job_id": "...", "status": "queued"}. acknowledged: true confirms you own the video or have
permission to use it. target_clips is 1 to 15; leave it out and the AI decides. To send a file, post multipart form data
with a file field (up to 100 MB) and the same fields.
Get the clips
curl https://aiclipmaker.org/api/status/JOB_ID -H "Authorization: Bearer acm_..."
While it runs you get status (queued, processing, completed, failed) and the current stage. When it completes,
result.clips lists each clip with:
title,startandendin the source video;- ready-to-paste text:
video_title_for_youtube_short,video_description_for_tiktok,video_description_for_instagram; viral_hook_text,predicted_scoreandwhythe moment was picked;download_url, signed and valid for 24 hours without a cookie.
Webhooks
With webhook_url set (public https only), we POST once when the job ends: {"event": "job.completed", "job_id", "status",
"clips": [...]} or job.failed with the error. With webhook_secret, the body is signed with HMAC-SHA256 and the
signature sent as X-OpenShorts-Signature: sha256=....
Minutes and limits
API jobs use your plan's minutes, like uploads in the app. When there are not enough, the answer is HTTP 402 with
quota_exceeded, the minutes left and a link to pricing. GET /api/me returns your plan and
minutes left.
From an AI agent
The same pipeline is available as an MCP server, for Claude Code, Claude Desktop, Cursor and other MCP clients.
FAQ
- How do I authenticate?
- Create an API key in the app (Settings, API keys) and send it as Authorization: Bearer acm_... on every request.
- How do I know when a job is done?
- Poll GET /api/status/
, or pass webhook_url (and optionally webhook_secret) to POST /api/process. We POST job.completed or job.failed to it, signed with HMAC-SHA256 in X-OpenShorts-Signature when you set a secret. - Can I upload a file instead of a link?
- Yes, as multipart form data with a file field, up to 100 MB per request. Larger files: use the dashboard (up to 2 GB) or a link.
- How long are download links valid?
- The download_url of each clip is signed and works without a cookie for 24 hours. Ask GET /api/status again for fresh links.
- Is the API compatible with OpenShorts?
- The request and response shapes follow OpenShorts' API, so its MIT CLI and scripts work with OPENSHORTS_API_URL set to https://aiclipmaker.org and an acm_ key.