API למפתחים · שרת MCP

חתכו קליפים מ-YouTube מהקוד שלכם.

Name: AppsGolem API & MCP
Price: 5 EUR
Availability: InStock

REST API פשוט ושרת MCP עבור סוכני AI — כל מה שכלי הגזירה באתר עושה, באופן פרוגרמטי. קרדיטים בתשלום מראש, ללא מנוי.

# one clip = 1 credit — failed cuts never billed
curl -X POST https://appsgolem.com/v1/cuts \
  -H "Authorization: Bearer ag_live_…" \
  -d '{"url":"youtu.be/…","start":"0:00",
       "end":"0:10","mode":"video"}'

איך זה עובד

חדש כאן? כל המודל בדקה אחת.

אתם רוכשים קרדיטים בתשלום מראש, יוצרים מפתח API, וקוראים לנקודת קצה אחת כדי לחתוך קליפ. החיתוך הוא אסינכרוני: שולחים משימה, בודקים סטטוס עד שהיא מופקת, ואז מורידים את הקובץ מכתובת עם אסימון. שרת ה-MCP עוטף את כל זה בקריאה אחת לכלי עבור סוכני בינה מלאכותית. אין מנוי, אין מקומות — משלמים לפי כל קליפ שמופק.

1 · אימות

שלחו את המפתח שלכם כ-Authorization: Bearer ag_live_… בכל בקשה.

2 · שליחה ובדיקת סטטוס

POST /v1/cuts מחזיר מזהה משימה; בדקו סטטוס עם GET /v1/cuts/{id} עד שהיא מופקת.

3 · הורד

קבלו את download_url מהמשימה המופקת — אין צורך בכותרת, האסימון מאשר את הגישה.

התחלה מהירה

מאפס לקליפ בארבע קריאות.

01

צור מפתח API

Buy a credit pack (from €5), then generate a key in your dashboard. Keys look like ag_live_… and are shown once — store it somewhere safe.

02

שלח חיתוך

curl -X POST https://appsgolem.com/v1/cuts \
  -H "Authorization: Bearer ag_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://youtu.be/aqz-KE-bpKQ",
       "start":"0:00","end":"0:10",
       "resolution":"1080p","mode":"video"}'

import httpx
r = httpx.post("https://appsgolem.com/v1/cuts",
  headers={"Authorization": "Bearer ag_live_…"},
  json={"url": "https://youtu.be/aqz-KE-bpKQ",
        "start": "0:00", "end": "0:10",
        "resolution": "1080p", "mode": "video"})
print(r.json())   # {"id": "…", "state": "queued"}

const r = await fetch("https://appsgolem.com/v1/cuts", {
  method: "POST",
  headers: { Authorization: "Bearer ag_live_…" },
  body: JSON.stringify({
    url: "https://youtu.be/aqz-KE-bpKQ",
    start: "0:00", end: "0:10",
    resolution: "1080p", mode: "video" }),
});
console.log(await r.json());

202 Accepted

{ "id": "e48d…b1a2", "state": "queued", "credits_reserved": 1, "poll_url": "/v1/cuts/e48d…b1a2" }

03

בדוק שוב ושוב לקבלת כתובת ההורדה

# GET /v1/cuts/{id} — repeat every few seconds until state is produced
{ "state": "produced",
  "download_url": "/v1/download/…/clip.mp4" }

המצבים נעים בין accepted → queued → produced → delivered (או failed → refunded). קליפ קצר בדרך כלל מוכן תוך שניות; בדקו סטטוס כל 3–5 שניות.

קישורי ההורדה פגים כעבור 72 שעות מרגע יצירת הקטע — יש להוריד אותו בטווח זמן זה.

04

הורד את הקליפ

כתובת URL עם טוקן מזרימה את ה-MP4 — ניתנת לשימוש חוזר עד לתפוגה. כלי ה-MCP בשם cut_youtube_video מבצע עבורכם את שלבים 2–4 בקריאה אחת.

עבור סוכני AI · MCP

שורה אחת עבור Claude, Cursor ו-Codex.

שרת ה-MCP חושף את כלי הגזירה כשלושה כלים שכל לקוח MCP יכול לקרוא להם. התקינו באמצעות npx — אין צורך להתקין דבר גלובלית.

Claude Desktop — claude_desktop_config.json

{ "mcpServers": {
  "appsgolem": {
    "command": "npx",
    "args": ["-y","appsgolem-mcp"],
    "env": { "APPSGOLEM_API_KEY":
      "ag_live_…" } } } }

Claude Code

claude mcp add appsgolem \
  -e APPSGOLEM_API_KEY=ag_live_… \
  -- npx -y appsgolem-mcp

Codex CLI — ~/.codex/config.toml

[mcp_servers.appsgolem]
command = "npx"
args = ["-y", "appsgolem-mcp"]
env = { APPSGOLEM_API_KEY = "ag_live_…" }

cut_youtube_video()

שלח חיתוך (כל מצב, אפשרויות או מערך קליפים) ותקבל בחזרה כתובת URL להורדה.

get_cut_status()

בדוק משימה לפי מזהה וקבל את כתובת ההורדה שלה.

get_account_balance()

הקרדיטים הזמינים לשימוש שלכם והתקרה השעתית.

מה להגיד לסוכן שלכם — כל היכולות

“חיתוך מ-0:30 עד 1:15 מתוך סרטון באיכות 1080p”

cut_youtube_video(url, start="0:30", end="1:15", resolution="1080p")

“חילוץ השמע של הסרטון בין 2:00–5:00 כקובץ MP3 בקצב 320 kbps”

cut_youtube_video(…, mode="audio_only", audio_format="mp3", bitrate="320")

“ייצוא הסרטון וקובץ MP3 של 30 השניות הראשונות”

cut_youtube_video(…, end="0:30", mode="both")

“יצירת סרטון קצר אנכי ביחס 9:16 מהרגע הבולט בין 10:00–10:45”

cut_youtube_video(…, start="10:00", end="10:45", mode="short")

“הפיכת 0:05–0:12 ל-GIF”

cut_youtube_video(…, mode="gif")

“חילוץ גיליון תמונות (sheet) עם פריים כל 5 שניות בין 1:00–2:00”

cut_youtube_video(…, mode="frames", interval_ms=5000, sheet=true)

“חיבור (stitch) 0:10–0:20 ו-1:00–1:10 לקליפ אחד”

cut_youtube_video(url, clips=[…], stitch=true)

“ביצוע חיתוך מהיר (fast) בשיטת stream-copy עבור 30 השניות הראשונות”

cut_youtube_video(…, end="0:30", fast=true)

“חיתוך 0:00–0:20 במהירות ×1.5, באיכות 4K”

cut_youtube_video(…, speed=1.5, resolution="2160p")

“כמה קרדיטים של API נותרו לי?”

get_account_balance()

“בדיקת סטטוס המשימה e48d…b1a2”

get_cut_status(job_id="e48d…b1a2")

הסוכן ממלא את הפרמטרים מתוך הבקשה שלכם — אתם לא כותבים JSON.

תיעוד API

כל נקודת קצה, עם דוגמאות.

ארבע נקודות קצה. שלוש נקודות הקריאה/כתיבה דורשות Authorization: Bearer <key>; כתובת ההורדה מאושרת על ידי האסימון שלה, כך שאינה זקוקה לכותרת.

POST /v1/cuts Bearer

בקשה · video

{ "url": "https://youtu.be/aqz-KE-bpKQ",
  "start": "0:00", "end": "0:10",
  "resolution": "1080p", "mode": "video" }

תגובה · 202 Accepted

{ "id": "e48db1a2-…", "state": "queued", "credits_reserved": 1, "poll_url": "/v1/cuts/e48db1a2-…" }

העבירו start+end או מערך clips (1–10 טווחים). הוסיפו כותרת Idempotency-Key (עד ≤200 תווים) כך שבקשה חוזרת תשתמש שוב באותה משימה במקום לחייב פעמיים.

גוף הבקשה לפי מצב

audio_onlymp3 · m4a · wav · flac

{ "url":"youtu.be/…", "start":"2:00", "end":"5:00",
  "mode":"audio_only",
  "audio_format":"mp3", "bitrate":"320" }

bothMP4 + MP3, בקובץ ZIP

{ "url":"youtu.be/…", "start":"0:00", "end":"0:30",
  "mode":"both", "resolution":"1080p" }

shortחיתוך חכם בבינה מלאכותית ביחס 9:16

{ "url":"youtu.be/…", "start":"10:00", "end":"10:45",
  "mode":"short" }

nosoundMP4, ללא שמע

{ "url":"youtu.be/…", "start":"0:00", "end":"0:15",
  "mode":"nosound", "fast":true }

gif≤ 5 דקות, קליפ יחיד

{ "url":"youtu.be/…", "start":"0:05", "end":"0:12",
  "mode":"gif" }

framesתמונות JPG · ≤ 1800

{ "url":"youtu.be/…", "start":"1:00", "end":"2:00",
  "mode":"frames", "interval_ms":5000,
  "sheet":true }

clips + stitch1–10 → קובץ אחד

{ "url":"youtu.be/…", "mode":"video",
  "clips":[{"start":"0:10","end":"0:20"},
          {"start":"1:00","end":"1:10"}],
  "stitch":true }

speed · 4K0.5–2× · 2160p

{ "url":"youtu.be/…", "start":"0:00", "end":"0:20",
  "mode":"video", "speed":1.5,
  "resolution":"2160p" }

GET /v1/cuts/{id} Bearer

תגובה · 200 · produced

{ "id": "e48db1a2-…", "state": "produced", "credits_reserved": 1,
  "created_at": "2026-08-22T12:00:00+00:00",
  "download_url": "/v1/download/…/clip.mp4" }

state הוא אחד מ-accepted · queued · produced · delivered · failed · refunded. download_url מופיע ברגע שהאסימון מוכן — אם הוא חסר, בדקו סטטוס שוב.

GET /v1/account Bearer

תגובה · 200

{ "balance": 412, "hourly_cap": 60 }

GET /v1/download/{token}/{file} אסימון בכתובת

תגובה · 200

# streams the file
Content-Type: video/mp4
Content-Disposition: attachment; filename="clip.mp4"

אין כותרת Bearer — האסימון בנתיב מאשר את הגישה. הכתובת ניתנת לשימוש חוזר עד שפוקעת.

שגיאות

כל כשל מחזיר גוף JSON עם קוד error וסטטוס HTTP. נסו שוב עבור 429 אחרי retry_after שניות; תקנו ושלחו מחדש עבור 400.

402 insufficient_credits

{ "error":"insufficient_credits",
  "message":"need 2 credits", "balance":1 }

429 rate_limited

{ "error":"rate_limited",
  "retry_after":12 }

400 invalid_*

{ "error":"invalid_resolution",
  "message":"resolution must be…" }

401 · 404

{ "error":"invalid_api_key" }  // 401
{ "error":"not_found" }        // 404

הגבלת קצב: רק הגשות חיתוך כפופות להגבלת קצב — מספר ההגשות בשעה בהתאם לתוכנית שלך (ראו תמחור). בדיקת ההתקדמות של עבודה אינה כפופה להגבלת קצב בשימוש רגיל, כך שסקר תקופתי (polling) לעולם לא נכלל במכסה הזו. יש לכבד את poll_after בכל תגובה (ואת Retry-After במקרים הנדירים של 429); כלי ה-MCP מווסת זאת עבורכם באמצעות wait=true.

יכולות

כל מצב שיש בכלי הגזירה באתר.

MODE video

MP4 עד 4K

144p–2160p, 60fps, ללא סימן מים.

MODE audio_only

אודיו

mp3 / m4a / wav / flac, קצב סיביות ניתן לבחירה.

MODE both

וידאו + אודיו

MP4 ו-MP3 יחד, כקובץ zip.

MODE nosound

וידאו ללא קול

וידאו ללא פס קול.

MODE short

9:16 אנכי

גזירה חכמה מבוססת AI עבור Shorts, Reels ו-TikTok; חוזר למסגור מטושטש כשלא זמין.

MODE gif

GIF מונפש

עד 5 דקות, ישירות מתוך קליפ.

MODE frames

פריימי JPG

כל 100ms–10s, חותמות זמן + גיליון מגע.

OPTION fast

מצב מהיר

העתקת זרם (Stream-copy), מהיר פי 10 בערך; שומר על מארז המקור (WebM ברזולוציה של 1440p/2160p).

OPTION speed

מהירות 0.5–2×

שינוי מהירות הניגון בייצוא.

OPTION clips

תפירת קליפים מרובים

עד 10 חלונות זמן המחוברים לקובץ אחד.

רפרנס

פרמטרים

שדה

סוג

הערות

url

string

כתובת YouTube מסוג צפייה / שיתוף / youtu.be.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). יש להשמיט בעת שימוש בקליפים.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; משך החיתוך הכולל ≤ 60 דק').

mode

enum

video · audio_only · both · nosound · short · gif · frames.

audio_format

enum

mp3 · m4a · wav · flac — עבור audio_only בלבד; both הוא תמיד MP3.

bitrate

enum

קצב סיביות עם אובדן 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); מתעלמים ממנו ב-wav/flac.

fast

boolean

Stream-copy, מהיר פי 10× בערך — video, nosound, both בלבד; כופה מהירות של 1×.

speed

number

מהירות ניגון 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

דגימת תמונות: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG בסך הכול.

burn_ts

boolean

תמונות — צריבת חותמת הזמן של המקור על כל JPG.

sheet

boolean

תמונות — JPG יחיד של גיליון מגע (קליפ יחיד); משבית את burn_ts.

clips

array

1–10 חלונות {start,end}; הגדירו stitch כדי לחבר לקובץ אחד.

stitch

boolean

כאשר יש clips, מאחדים אותם לקובץ אחד — video, audio_only, both, short, nosound.

Idempotency-Key

header

נשלח ככותרת HTTP (≤ 200 תווים), לא כשדה בגוף הבקשה — ניסיונות חוזרים משתמשים באותה משימה.

נקודות קצה: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — אימות Bearer.
GET /v1/download/{token}/{file} — מאומת באמצעות טוקן ה-URL, ללא כותרת Bearer.

מחירים

שלמו על קליפים, לא על משתמשים.

קרדיטים בתשלום מראש מפעילים את ה-API של כלי החיתוך של AppsGolem & שרת ה-MCP — כל קליפ שנוצר שווה קרדיט אחד, וחיתוכים כושלים לעולם לא מחויבים בתשלום. קנה חבילה לשימוש מזדמן, או הירשם למנוי לנפח חודשי קבוע ולמגבלת קצב גבוהה יותר.

№ 01 / חבילות בתשלום מראש