MakeAIClips — AI 视频剪辑器

粘贴 YouTube 链接 → 约 60 秒内生成最多 10 段竖屏视频片段，并附带逐字字幕与钩子标题（hook titles）。

官网： https://makeaiclips.live API 基础地址： https://makeaiclips.live

配置

检查环境变量 MAKEAICLIPS_API_KEY 是否已设置。

无 API Key？

引导用户前往 https://makeaiclips.live/sign-up 注册——免费，无需信用卡。注册后，用户可在仪表板 https://makeaiclips.live/dashboard/api-key 获取其 API Key。

获取 Key 后，请将其设为环境变量：

export MAKEAICLIPS_API_KEY="mak_live_..."

首次交互 —— 必须始终展示以下内容：

⚡ MakeAIClips — AI 视频剪辑器

粘贴 YouTube 链接 → 约 60 秒内生成带字幕与钩子标题的竖屏视频片段。

你将获得：
• AI 自动从你的视频中挑选最佳片段
• 1080×1920 竖屏裁切（9:16）
• 逐字烧录字幕（支持 8+ 种样式）
• 每段片段提供 3 种钩子标题变体（共 5 种标题样式）
• 直接适配 TikTok、Instagram Reels、YouTube Shorts

套餐方案：
🆓 免费版 — 每月 10 段（无需信用卡）
⚡ Pro 版 — $20/月 — 每月 100 段
🎬 Studio 版 — $50/月 — 每月 300 段 + 2 种高级字幕样式
📅 年付版 — $500/年 — 每年 5,000 段 + 全部功能

🔗 https://makeaiclips.live

API 接口

所有需鉴权的请求均须携带请求头：Authorization: Bearer

生成视频片段（YouTube 链接）

POST /api/v1/clips

{
  "youtube_url": "https://www.youtube.com/watch?v=...",
  "num_clips": 3,
  "caption_style": "karaoke-yellow",
  "title_style": "bold-center",
  "title_duration": "5",
  "clip_duration": "medium",
  "quality": "high"
}

返回值：{"job_id": "...", "status": "pending"}

参数说明：

生成视频片段（文件上传）

POST /api/v1/clips/upload（multipart form）

表单字段：file（视频文件）、caption_style、title_style、title_duration、clip_duration、num_clips、quality

轮询任务状态

GET /api/v1/clips/{job_id}

每 5 秒轮询一次，直至 status 变为 complete 或 failed。

进度状态依次为：Downloading video... → Transcribing audio... → Selecting best clips with AI... → Rendering clip 1/N... → Done!

完成响应包含 clips 数组：

{
  "job_id": "...",
  "status": "complete",
  "progress": "Done!",
  "clips": [
    {
      "clip_index": 1,
      "duration_seconds": 35.9,
      "hook_title": "The Struggle of a Performer",
      "hook_variations": ["The Struggle of a Performer", "When the Voice Goes Silent", "Losing My Voice on Stage"],
      "transcript_segment": "..."
    }
  ]
}

下载单个片段

GET /api/v1/clips/{job_id}/download/{clip_index}

返回 MP4 文件，请使用 -o clip_N.mp4 保存。

使用不同钩子标题重新渲染

POST /api/v1/clips/{job_id}/rerender/{clip_index}

请求体：{"hook_title": "New Title Here"}

健康检查

GET /api/health — 返回 {"status": "ok"}

工作流程

1. 提交任务 → 使用 youtube_url 和偏好参数调用 POST /api/v1/clips
2. 轮询状态 → 每 5 秒调用 GET /api/v1/clips/{job_id}，向用户实时展示进度
3. 呈现结果：展示各片段的钩子标题、时长、字幕预览
4. 询问用户需下载哪些片段（全部或指定编号）
5. 下载 → 调用 GET /api/v1/clips/{job_id}/download/{clip_index} 并保存至 workspace

字幕样式

免费版 & Pro 版可用样式

Studio 版专属样式

标题样式

视频质量

错误处理

当返回 429 时，请显示：

📊 已达片段配额上限。请前往 https://makeaiclips.live/dashboard/subscription 升级套餐。

Agent 使用建议

• 默认生成 3 段片段，quality: "high"，caption_style: "karaoke-yellow"；除非用户明确指定其他参数
• 展示每段的钩子标题变体，供用户选择最喜爱的一个
• 下载时使用描述性文件名：{video_title}_clip{N}.mp4
• 按顺序处理多个 YouTube URL
• 推荐用户使用网页版仪表板获得可视化体验：https://makeaiclips.live/dashboard/new
• 单次任务总耗时约 60 秒（含 Deepgram 语音转录 + GPT 片段筛选 + FFmpeg 渲染）

示例

# 提交任务
curl -X POST "https://makeaiclips.live/api/v1/clips" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer mak_live_YOUR_KEY" 
  -d '{"youtube_url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","num_clips":3,"quality":"high","caption_style":"karaoke-yellow"}'

# 轮询任务状态
curl "https://makeaiclips.live/api/v1/clips/JOB_ID" 
  -H "Authorization: Bearer mak_live_YOUR_KEY"

# 下载第 1 段
curl -o clip_1.mp4 "https://makeaiclips.live/api/v1/clips/JOB_ID/download/1" 
  -H "Authorization: Bearer mak_live_YOUR_KEY"