डेवलपर API · MCP सर्वर

YouTube क्लिप्स अपने कोड से काटें।

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

AI एजेंट्स के लिए एक सरल REST API और MCP सर्वर — वह सब कुछ जो वेब कटर करता है, प्रोग्रामेटिक रूप से। प्रीपेड क्रेडिट, कोई सदस्यता नहीं।

API कुंजी प्राप्त करें त्वरित शुरुआत

कोडिंग एजेंट्स के लिए API + MCP →

# 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 की बनाते हैं, और क्लिप काटने के लिए एक एंडपॉइंट कॉल करते हैं। कटिंग असिंक्रोनस होती है: आप एक जॉब सबमिट करते हैं, उसके तैयार होने तक स्थिति जांचते रहते हैं, फिर एक टोकन-युक्त URL से फ़ाइल डाउनलोड करते हैं। MCP सर्वर इन सभी को AI एजेंट्स के लिए एक ही टूल कॉल में समेट देता है। कोई सब्सक्रिप्शन नहीं, कोई सीट नहीं — आप हर तैयार क्लिप के हिसाब से भुगतान करते हैं।

1 · प्रमाणीकरण

हर रिक्वेस्ट में अपनी की Authorization: Bearer ag_live_… के रूप में भेजें।

2 · सबमिट करें और स्थिति जांचें

POST /v1/cuts एक जॉब id लौटाता है; जब तक वह तैयार न हो जाए, 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

डाउनलोड URL के लिए बार-बार जाँच करें

# 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()

आईडी के आधार पर किसी जॉब की जाँच करें और उसका डाउनलोड URL पाएं।

get_account_balance()

आपके खर्च करने योग्य क्रेडिट और प्रति घंटा सीमा।

अपने एजेंट से क्या कहें — हर क्षमता

“1080p में किसी वीडियो का 0:30 से 1:15 तक हिस्सा काटें”

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

“उस वीडियो का 2:00–5:00 वाला ऑडियो 320 kbps MP3 के रूप में निकालें”

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

“पहले 30 सेकंड का वीडियो और एक MP3 एक्सपोर्ट करें”

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

“10:00–10:45 के हाइलाइट का 9:16 वर्टिकल शॉर्ट बनाएं”

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

“0:05–0:12 को GIF में बदलें”

cut_youtube_video(…, mode="gif")

“1:00–2:00 के बीच हर 5 सेकंड पर एक फ्रेम की कॉन्टैक्ट शीट (sheet) निकालें”

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

“0:10–0:20 और 1:00–1:10 को जोड़कर (stitch) एक क्लिप बनाएं”

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

“पहले 30 सेकंड का तेज़ (fast), stream-copy कट करें”

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

“4K में 0:00–0:20 को 1.5× स्पीड पर काटें”

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> चाहिए; डाउनलोड URL अपने ही टोकन से अधिकृत होता है, इसलिए उसे किसी हेडर की ज़रूरत नहीं।

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, ज़िप में

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

short9:16 AI स्मार्ट-क्रॉप

{ "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" }

framesJPG स्टिल्स · ≤ 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} URL में टोकन

रिस्पॉन्स · 200

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

कोई Bearer हेडर नहीं — पाथ में मौजूद टोकन ही इसे अधिकृत करता है। यह URL समाप्त होने तक दोबारा उपयोग किया जा सकता है।

एरर्स

हर फेल होने पर error कोड और HTTP स्टेटस के साथ एक JSON बॉडी मिलती है। 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

रेट लिमिट: केवल कट सबमिशन दर-सीमित हैं — आपके प्लान के अनुसार प्रति घंटे सबमिशन की संख्या (मूल्य निर्धारण देखें)। किसी जॉब की प्रगति जाँचना सामान्य उपयोग में दर-सीमित नहीं है, इसलिए पोलिंग कभी भी उस सीमा में नहीं गिनी जाती। हर प्रतिक्रिया में poll_after का पालन करें (और दुर्लभ 429 पर Retry-After का); MCP टूल wait=true के साथ यह गति आपके लिए खुद सँभालता है।

क्षमताएँ

वेब कटर के सभी मोड।

MODE video

4K तक MP4

144p–2160p, 60fps, बिना वॉटरमार्क के।

MODE audio_only

ऑडियो

mp3 / m4a / wav / flac, चुनने योग्य बिटरेट।

MODE both

वीडियो + ऑडियो

MP4 और MP3 एक साथ, zip के रूप में।

MODE nosound

म्यूट वीडियो

बिना ऑडियो ट्रैक के वीडियो।

MODE short

9:16 वर्टिकल

Shorts, Reels और TikTok के लिए AI स्मार्ट-क्रॉप; उपलब्ध न होने पर धुंधली लेटरबॉक्सिंग पर वापस चला जाता है।

MODE gif

एनिमेटेड GIF

5 मिनट तक, सीधे क्लिप से।

MODE frames

JPG फ्रेम्स

हर 100ms–10s, टाइमस्टैम्प + कॉन्टैक्ट शीट।

OPTION fast

फ़ास्ट मोड

स्ट्रीम-कॉपी, लगभग 10× तेज़; सोर्स कंटेनर को बनाए रखता है (WebM, 1440p/2160p पर)।

OPTION speed

गति 0.5–2×

एक्सपोर्ट पर प्लेबैक की गति में बदलाव।

OPTION clips

मल्टी-क्लिप स्टिचिंग

अधिकतम 10 विंडो, एक फ़ाइल में जोड़ी गईं।

संदर्भ

पैरामीटर

फ़ील्ड

प्रकार

टिप्पणियाँ

url

string

YouTube वॉच / शेयर / youtu.be URL।

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 हेडर नहीं।

कीमतें

क्लिप्स के लिए भुगतान करें, सीट्स के लिए नहीं।

प्रीपेड क्रेडिट AppsGolem कटर API & MCP सर्वर को शक्ति देते हैं — बनाई गई हर क्लिप एक क्रेडिट के बराबर है, और असफल कट्स के लिए कभी शुल्क नहीं लिया जाता। कभी-कभार उपयोग के लिए एक पैक खरीदें, या स्थिर मासिक मात्रा और अधिक रेट लिमिट के लिए सब्सक्राइब करें।

№ 01 / प्रीपेड पैक

उपयोग अनुसार भुगतान करें।

एक बार की खरीद, कोई नवीनीकरण नहीं। क्रेडिट 12 महीनों तक वैध रहते हैं।

Starter पैक

€5 एकमुश्त

25 क्रेडिट · ≈ 25 स्टैंडर्ड क्लिप

12 महीनों तक वैध

शुरू करें

PAYG पैक सबसे बेहतरीन डील

€25 एकमुश्त

150 क्रेडिट · ≈ 150 स्टैंडर्ड क्लिप

12 महीनों तक वैध · €0.17 / क्रेडिट

शुरू करें

№ 02 / सब्सक्रिप्शन

हर महीने कट करें।

क्रेडिट हर अवधि में रिफ्रेश होते हैं और आपकी रेट लिमिट बढ़ जाती है। कभी भी रद्द करें।

Starter

€19 / माह

या €190 / वर्ष · 2 माह मुफ्त

250 क्रेडिट / माह

30 रिक्वेस्ट / घंटा
क्रेडिट हर महीने रिफ्रेश होते हैं
कभी भी रद्द करें

शुरू करें

★ सबसे लोकप्रिय Pro

€49 / माह

या €490 / वर्ष · 2 माह मुफ्त

1000 क्रेडिट / माह

60 रिक्वेस्ट / घंटा
क्रेडिट हर महीने रिफ्रेश होते हैं
कभी भी रद्द करें

शुरू करें

Scale

€149 / माह

या €1490 / वर्ष · 2 माह मुफ्त

5000 क्रेडिट / माह

120 रिक्वेस्ट / घंटा
क्रेडिट हर महीने रिफ्रेश होते हैं
कभी भी रद्द करें

शुरू करें

सब्सक्रिप्शन पूरी अवधि के क्रेडिट पहले से देते हैं और आपकी रिक्वेस्ट/घंटा सीमा बढ़ाते हैं। वार्षिक प्लान में 12 महीनों के लिए केवल 10 महीनों का शुल्क लिया जाता है।

№ 03 / क्रेडिट कैसे काम करते हैं