用 API 切片，或者直接跟 Claude 说一声。

在开发者页面创建密钥（任何账号、任何套餐都可以），然后提交视频：

curl -X POST https://highstyle.ai/api/v1/clip \
  -H "Authorization: Bearer hs_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-video-42" \
  -d '{
    "url": "https://youtube.com/watch?v=VIDEO_ID",
    "clips": 5,
    "style": "spotlight",
    "layout": "auto"
  }'

# 202 Accepted
# { "project_id": "…", "job_id": "…", "status": "queued",
#   "queued": true, "minutes_held": 60, "minutes_balance": 240,
#   "poll": "/api/v1/projects/…" }

Idempotency-Key 是可选的，但值得带上：一次 POST 超时后，你用同一个值重试，拿回的是原来的项目，而不是再跑一次、再预占一份额度。queued: false 表示这次请求没能把任务派出去执行，所以别默认它已经在跑，先轮询确认（一直没启动的任务会自动判为失败并退还额度）。

一次运行要几分钟（整条源视频都会转写并分析）。轮询直到 status 变成 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
# ] }

每个请求都用 bearer 密钥认证；读接口在任何套餐上都能用，所以你可以先把集成跑通再付费。出错时返回 JSON，带一条 error 说明和一个便于程序判断的 code：401 表示密钥缺失或已撤销；403 upgrade_required 表示免费版想跑切片；402 insufficient_credits 表示额度不足；400 invalid_option 表示取值不合法；429 rate_limited 会带上 Retry-After 头，出现在单个密钥每分钟超过 120 次请求之后。

下面任意一个都可以作为 style 传入。带动效的预设是默认外观；clean 专门给规则禁止花哨字幕或 AI 感字幕的悬赏活动用：字幕照样准确，但不带辉光、变色强调、弹跳动画和标题卡。

Add Highstyle to Claude once and it can clip for you in conversation. There is no API key to create and no client ID or secret to paste: the whole setup is the URL https://highstyle.ai/mcp, after which Claude sends you to Highstyle to sign in and you approve the connection once. Custom connectors work on every Claude plan, and a free Claude account can have one.

New to this? The step-by-step guide walks the whole setup with pictures. What follows is the short version.

Connect it

# Claude web, Desktop, mobile  (Pro, Max, and Free)
Customize > Connectors > + > Add custom connector

  Name:  Highstyle
  URL:   https://highstyle.ai/mcp

# Then Continue, and sign in to Highstyle when Claude sends you there.
# Leave Advanced settings alone: no client ID or secret is needed.

# Team and Enterprise: an Owner adds it first, under
# Organization settings > Connectors > Add > Custom > Web

On a Team or Enterprise plan a member cannot add one alone: an Owner adds it under Organization settings first, and it then shows up under Customize for everyone to connect individually.

# Claude Code, signing in through the browser
claude mcp add --transport http highstyle https://highstyle.ai/mcp

# Claude Code, using an API key instead of signing in
claude mcp add --transport http highstyle https://highstyle.ai/mcp \
  --header "Authorization: Bearer hs_live_..."

Claude asks Highstyle what it needs before it finishes adding the connector, so the sign-in happens there and then rather than later: you land on a Highstyle page naming the connection and the workspace it will spend minutes from, you approve once, and Claude returns holding a token tied to your account. The connection lasts until you disconnect it, in Claude or from your Connections page in Highstyle.

Then just ask

Claude reads the tool descriptions and picks what it needs, so you never name a tool yourself. Things people actually type:

• “Clip this podcast into 5 shorts and give me the best one: <YouTube URL>”
• “Use the clean caption style, no music, and make them tight”
• “How many minutes do I have left?”
• “Show me the top clip from that run”

A run takes several minutes, and Claude is told to wait rather than poll in a loop, so it holds the turn and comes back with ranked clips instead of asking you to check again. Each clip arrives with its title, hook, timestamps, a download URL and a share link, and asking to see one returns a still frame from the clip itself.

What Claude can do

Signing in, keys, and what each costs

Signing in through the connector and using an hs_live_ key are two ways into the same account, and they meet the same limits. Minutes come from your plan balance, the one the web app spends, and a run holds up to 60 minutes then charges the video's real length when it finishes.

Reading works on every plan, so you can connect, ask what Highstyle does and list your projects before paying. Starting a run needs a paid plan, and Claude is told to say so plainly and point you at an upgrade rather than failing in a way it cannot explain.

Every connection is listed on your Connections page, with the app that asked for it and when it was last used. Disconnecting takes effect immediately: the tokens are deleted rather than flagged, so the next tool call from that Claude conversation asks you to sign in again.

API、MCP 和网页端共用同一份分钟额度，按工作区计，所以套餐里的分钟就是集成能跑的分钟，不用另外买。提交时一个任务最多预占 60 分钟，跑完按源视频的真实时长扣费，剩下的预占自动退回。运行失败全额退还。任何人都可以创建密钥并用它读取数据，跑切片则需要任意一个付费套餐（19 美元/月起）。