Clipping Engine
Buat klip
POST
/api/v1/clipsMemotong klip pendek vertikal dari sebuah video YouTube. AI memilih momen di dalam rentang start_time sampai end_time, lalu merender sebanyak clip_count klip dengan pengaturan framing dan subtitle yang Anda kirim.
Autentikasi
MagerApiKey x-mager-api-key<token>
API key Mager
Di: header
Parameter header
x-mager-api-key*string
API key Mager
Body permintaan
application/json
Definisi TypeScript
Pakai tipe request body di TypeScript.
Body response
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/clips" \ -H "x-mager-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "start_time": "00:00:00", "end_time": "00:20:00", "clip_count": 3, "clip_length": "30-90s", "target_resolution": "1080p", "user_prompt": "Prefer moments with a strong opening line", "video_title": "How we grew to 10k users", "video_duration_seconds": 3120, "subtitle": { "with_subtitle": true, "font_style": "eridu", "font_size": 48, "max_words_on_screen": 3, "allowed_editing_styles": [ "STATIC_CROP", "DYNAMIC_CROP" ] }, "callback_url": "https://client.example.com/webhooks/mager" }'{ "status": 201, "message": "Success", "data": { "task_id": "cmclip01hxyz123", "status": "running", "model": null, "template_id": null, "callback_url": "https://client.example.com/webhooks/mager", "created_at": "2026-08-14T06:00:00.000Z", "updated_at": "2026-08-14T06:00:00.000Z", "completed_at": null, "error": null, "billing": { "base_moods": 1, "charged_moods": 2, "extra_moods_charged": 2 }, "output": null, "result": [], "webhooks": [] }}