One POST turns a YouTube URL into ranked, captioned, 9:16 clips. The same keys power an MCP endpoint, so Claude can run your clipping for you. Usage draws from the same minute balance as the app, and there are no separate API fees.
Create a key on your Developers page (any account can), then submit a video:
curl -X POST https://highstyle.ai/api/v1/clip \
-H "Authorization: Bearer hs_live_..." \
-H "Content-Type: application/json" \
-d '{
"url": "https://youtube.com/watch?v=VIDEO_ID",
"clips": 5,
"style": "reels",
"layout": "auto"
}'
# 202 Accepted
# { "project_id": "…", "job_id": "…", "status": "queued",
# "poll": "/api/v1/projects/…" }Runs take a few minutes (the whole source is transcribed and analyzed). Poll until status is done:
curl https://highstyle.ai/api/v1/projects/PROJECT_ID \
-H "Authorization: Bearer hs_live_..."
# { "status": "done", "clips": [
# { "rank": 1, "title": "…", "hook": "…",
# "virality_score": 8.6, "duration_ms": 41000,
# "video_url": "https://…mp4",
# "share_url": "https://highstyle.ai/c/…" },
# …ranked best-first
# ] }| Endpoint | What it does |
|---|---|
| POST /api/v1/clip | Submit a YouTube URL. Options: clips (1-50, default 10), style (caption preset, default reels; clean = no animation), layout (auto | fill | balanced | fit | split | track), title. |
| GET /api/v1/projects/{id} | Status, progress, and the finished clips ranked by predicted performance, each with a direct mp4 URL and a public share page URL. |
Authentication is a bearer key on every request. Errors are JSON with an error message: 401 for a bad key, 403 when the workspace isn't on a paid plan, 402 with code insufficient_credits when the minute balance is too low, 400 for invalid input.
Highstyle ships a hosted MCP server at https://highstyle.ai/mcp. Connect it once and Claude can submit videos, check progress, and hand you finished clips in conversation.
# Claude Code
claude mcp add --transport http highstyle https://highstyle.ai/mcp \
--header "Authorization: Bearer hs_live_..."
# Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"highstyle": {
"type": "http",
"url": "https://highstyle.ai/mcp",
"headers": { "Authorization": "Bearer hs_live_..." }
}
}
}Tools: submit_clip_job (YouTube URL in, project id out), get_project_status (progress, then ranked clips with URLs), and list_projects. Then it's just: “clip this podcast into 5 shorts and give me the best one.”
API and app share one minute balance per workspace. A job holds up to 60 minutes when submitted; when it finishes you're charged the actual source length and the rest of the hold is refunded automatically. Failed runs refund in full. Anyone can create keys, and requests work on any paid plan (from $19/mo).
Building something on this? We're early and responsive: webhook callbacks, uploads via API, and more tools land based on what integrators ask for. Reach us at support@highstyle.ai.