MakeAIClips API

# MakeAIClips API — Agent Reference ## ⚠️ IMPORTANT: How to Handle YouTube Videos DO NOT pass YouTube URLs directly to the API. Our server may get blocked by YouTube. Instead, follow this workflow: 1. Download the video YOURSELF using yt-dlp on YOUR machine: yt-dlp -f "bv[height<=1080]+ba/b" --merge-output-format mp4 -o "video.mp4" "YOUTUBE_URL" 2. Upload the downloaded file to our API (see below) 3. This works reliably because YOU download from YouTube with your own IP For Twitch clips, you can either: - Pass the URL directly to the API (works reliably), OR - Download with yt-dlp first and upload the file ## Quick Start Base URL: https://makeaiclips.live/api/v1 Auth: Authorization: Bearer mak_live_YOUR_KEY Get your API key at: https://makeaiclips.live/dashboard/api-key ## Endpoints ### Create Clips (File Upload — THE WAY TO DO IT) POST /api/v1/clips/upload Content-Type: multipart/form-data - video (file, required): MP4, MOV, or WebM video file - caption_style (string): karaoke-yellow | white-shadow | boxed | gradient-bold | subtitle-documentary | typewriter | cinematic | none - title_style (string): bold-center | top-bar | pill | gradient-bg | none - title_duration (string): 5 | 10 | 30 | half | full - clip_duration (string): short (15-30s) | medium (30-90s) | long (60-120s) - num_clips (number): 1-10 (default 3) - quality (string): high | medium | low ### Create Clips (URL — Twitch only, YouTube unreliable) POST /api/v1/clips Content-Type: application/json Body: { "youtube_url": "https://...", "caption_style": "karaoke-yellow", "num_clips": 3, ... } Supports: Twitch clip URLs (reliable), YouTube URLs (may fail — use file upload instead) ### Check Job Status GET /api/v1/clips/{job_id} Poll every 3-5 seconds. Status values: pending → processing → complete | failed When complete, clips array contains download URLs. ### Download Clip GET /api/v1/clips/{job_id}/download/{clip_index} Returns MP4 file (1080x1920, 9:16 vertical). ### Check Usage GET /api/v1/usage Returns: { plan, clips_used, clips_limit, clips_remaining, resets_at } ### Regenerate API Key POST /api/v1/keys/regenerate Old key immediately stops working. ## Plans - Free: 10 clips/month ($0) - Pro: 100 clips/month ($20) - Studio: 300 clips/month ($50) ## The Correct Workflow for YouTube Videos 1. pip install yt-dlp (if not installed) 2. yt-dlp -f "bv[height<=1080]+ba/b" --merge-output-format mp4 -o "video.mp4" "YOUTUBE_URL" 3. Upload video.mp4 to POST /api/v1/clips/upload 4. Poll GET /api/v1/clips/{job_id} until status=complete 5. Download clips from the download_url in each clip object 6. Clean up the local video file DO NOT try to pass YouTube URLs to the /api/v1/clips endpoint. DO NOT try to fix cookies or proxies. Just download locally and upload. ## Error Codes 400: Bad request (missing video/URL) 401: Invalid or missing API key 429: Clip limit reached (upgrade plan) 502: Backend unavailable (try again in 1 min) 503: Service temporarily overloaded ## Full Example (Python) — YouTube → Clips import subprocess, requests, time, os API_KEY = "mak_live_YOUR_KEY" BASE = "https://makeaiclips.live/api/v1" H = {"Authorization": f"Bearer {API_KEY}"} YOUTUBE_URL = "https://youtube.com/watch?v=VIDEO_ID" # Step 1: Download with yt-dlp (YOUR machine, YOUR IP — no blocks) subprocess.run(["yt-dlp", "-f", "bv[height<=1080]+ba/b", "--merge-output-format", "mp4", "-o", "video.mp4", YOUTUBE_URL], check=True) # Step 2: Upload to MakeAIClips with open("video.mp4", "rb") as f: job = requests.post(f"{BASE}/clips/upload", files={"video": f}, data={"num_clips": "3", "caption_style": "karaoke-yellow", "quality": "high"}, headers=H).json() print(f"Job started: {job['job_id']}") # Step 3: Poll until done while True: r = requests.get(f"{BASE}/clips/{job['job_id']}", headers=H).json() if r["status"] == "complete": for c in r["clips"]: print(f"Clip {c['clip_index']}: {c['hook_title']}") print(f"Download: https://makeaiclips.live{c['download_url']}") break if r["status"] == "failed": print(f"Error: {r.get('error')}") break time.sleep(3) # Step 4: Clean up os.remove("video.mp4") ## Chrome Extension For browser-based YouTube clipping, install the MakeAIClips Chrome extension: https://makeaiclips.live/extension The extension enables direct YouTube link processing from the dashboard.