Geliştirici API · MCP sunucusu

YouTube kliplerini kendi kodunuzdan kesin.

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

AI ajanları için basit bir REST API ve MCP sunucusu — web kesicinin yaptığı her şeyi, programatik olarak. Ön ödemeli krediler, abonelik yok.

Bir API anahtarı alın Hızlı başlangıç

Kodlama ajanları için 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"}'

Nasıl çalışır

Yeni misiniz? Tüm model bir dakikada.

Ön ödemeli krediler satın alırsınız, bir API anahtarı oluşturursunuz ve bir klip kesmek için tek bir endpoint çağırırsınız. Kesim işlemi asenkrondur: bir iş gönderirsiniz, üretilene kadar poll edersiniz, ardından dosyayı token'lı bir URL'den indirirsiniz. MCP sunucusu tüm bunları AI ajanları için tek bir araç çağrısında birleştirir. Abonelik yok, sabit kullanıcı sayısı yok — yalnızca ürettiğiniz klip başına ödersiniz.

1 · Kimlik Doğrulama

Anahtarınızı her istekte Authorization: Bearer ag_live_… olarak gönderin.

2 · Gönder & poll et

POST /v1/cuts bir iş kimliği döndürür; üretilene kadar GET /v1/cuts/{id} üzerinde poll edin.

3 · İndir

Üretilen işten download_url değerini alın — header gerekmez, token onu yetkilendirir.

Hızlı başlangıç

Dört çağrıda sıfırdan klibe.

01

Bir API anahtarı oluşturun

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

Bir kesim gönderin

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

İndirme URL'sini yoklayın

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

Durumlar accepted → queued → produced → delivered şeklinde ilerler (ya da failed → refunded). Kısa bir klip genellikle saniyeler içinde hazır olur; her 3–5 s'de bir poll edin.

İndirme bağlantıları klip oluşturulduktan 72 saat sonra sona erer — bu süre içinde indirin.

04

Klibi indirin

Jetonlu URL, MP4'ü akışa alır — süresi dolana kadar yeniden kullanılabilir. MCP aracı cut_youtube_video, 2–4. adımları sizin için tek bir çağrıda halleder.

AI ajanları için · MCP

Claude, Cursor & Codex için tek satır.

MCP sunucusu, kesiciyi herhangi bir MCP istemcisinin çağırabileceği üç araç olarak sunar. npx ile kurun — global olarak kurulacak bir şey yok.

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

Bir kesim gönderin (herhangi bir mod, seçenekler veya bir klip dizisi) ve karşılığında bir indirme URL'si alın.

get_cut_status()

Bir işi id'ye göre kontrol edin ve indirme URL'sini alın.

get_account_balance()

Harcanabilir krediniz ve saatlik limitiniz.

Ajanınıza ne söyleyeceğiniz — tüm yetenekler

“Bir videonun 0:30'dan 1:15'e kadar olan kısmını 1080p'de kes”

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

“O videonun 2:00–5:00 arasındaki sesini 320 kbps MP3 olarak al”

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

“İlk 30 saniyenin videosunu ve bir MP3'ünü dışa aktar”

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

“10:00–10:45 öne çıkan bölümünden 9:16 dikey bir kısa video oluştur”

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

“0:05–0:12 aralığını GIF'e dönüştür”

cut_youtube_video(…, mode="gif")

“1:00–2:00 arasından her 5 saniyede bir kare alan bir contact sheet çıkar”

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

“Stitch ile 0:10–0:20 ve 1:00–1:10 aralıklarını tek bir klipte birleştir”

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

“İlk 30 saniye için fast, stream-copy bir kesim yap”

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

“0:00–0:20 aralığını 1.5× hızda, 4K olarak kes”

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

“Kaç API kredim kaldı?”

get_account_balance()

“e48d…b1a2 işini kontrol et”

get_cut_status(job_id="e48d…b1a2")

Ajan, parametreleri isteğinizden doldurur — JSON yazmanız gerekmez.

API referansı

Örneklerle birlikte her endpoint.

Dört endpoint. Üç okuma/yazma endpoint'i Authorization: Bearer <key> alır; indirme URL'si kendi token'ı ile yetkilendirilir, bu yüzden header gerektirmez.

POST /v1/cuts Bearer

İstek · video

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

Yanıt · 202 Accepted

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

start+end ya da bir clips dizisi (1–10 pencere) geçin. Yeniden denenen bir isteğin iki kez ücretlendirilmek yerine aynı işi yeniden kullanması için bir Idempotency-Key header'ı (≤200 karakter) ekleyin.

Mode başına istek gövdesi

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'lenmiş

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

short9:16 AI smart-crop

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

nosoundMP4, ses yok

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

gif≤ 5 dk, tek klip

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

framesJPG kareler · ≤ 1800

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

clips + stitch1–10 → tek dosya

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

Yanıt · 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 değerlerinden biridir. Bir token hazır olduğunda download_url görünür — yoksa tekrar poll edin.

GET /v1/account Bearer

Yanıt · 200

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

GET /v1/download/{token}/{file} URL'de Token

Yanıt · 200

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

Bearer header yok — yoldaki (path) token onu yetkilendirir. URL, süresi dolana kadar yeniden kullanılabilir.

Hatalar

Her hata, bir error kodu ve HTTP durumu içeren bir JSON gövdesi döndürür. 429 için retry_after saniye sonra yeniden deneyin; bir 400 durumunda düzeltip yeniden gönderin.

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

Hız sınırı: Yalnızca kesim gönderimleri hız sınırlamasına tabidir — planınızın gönderim/saat sınırı (bkz. Fiyatlandırma). Bir işin ilerleme durumunu kontrol etmek normal kullanımda hız sınırlamasına tabi değildir, bu nedenle yoklama bu sınıra asla dahil edilmez. Her yanıtta poll_after değerine uyun (nadir görülen 429 durumunda ise Retry-After değerine); MCP aracı, wait=true kullanıldığında bu hızı sizin için ayarlar.

Yetenekler

Web kesicinin sahip olduğu her mod.

MODE video

4K'ya kadar MP4

144p–2160p, 60fps, filigran yok.

MODE audio_only

Ses

mp3 / m4a / wav / flac, seçilebilir bit hızı.

MODE both

Video + ses

MP4 ve MP3 birlikte, zip olarak.

MODE nosound

Sessiz video

Ses parçası çıkarılmış video.

MODE short

9:16 dikey

Shorts, Reels ve TikTok için AI akıllı kırpma; kullanılamadığında bulanık siyah bantlara geri döner.

MODE gif

Hareketli GIF

Bir klipten doğrudan, 5 dakikaya kadar.

MODE frames

JPG frames

Her 100ms–10s'de bir, zaman damgaları + kontakt sayfası.

OPTION fast

Hızlı mod

Stream kopyalama, yaklaşık 10× daha hızlı; kaynak kapsayıcı formatını korur (WebM, 1440p/2160p).

OPTION speed

Hız 0.5–2×

Dışa aktarımda oynatmayı yeniden zamanlar.

OPTION clips

Çoklu klip birleştirme

Tek bir dosyada birleştirilen en fazla 10 pencere.

Referans

Parametreler

Alan

Tür

Notlar

url

string

YouTube izleme / paylaşım / youtu.be URL'si.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Klip kullanırken atlayın.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; toplam kesim ≤ 60 dk).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — sadece audio_only için; both her zaman MP3'tür.

bitrate

enum

Kayıplı bit hızı 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); wav/flac için yoksayılır.

fast

boolean

Stream-copy, yaklaşık 10× daha hızlı — yalnızca video, nosound, both; hızı 1×'e zorlar.

speed

number

Oynatma hızı 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Kare örnekleme: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG toplam.

burn_ts

boolean

Kareler — kaynak zaman damgasını her JPG'nin üzerine işler.

sheet

boolean

Kareler — tek bir contact sheet JPG (tek klip); burn_ts'yi devre dışı bırakır.

clips

array

1–10 {start,end} penceresi; tek bir dosyada birleştirmek için stitch seçeneğini kullanın.

stitch

boolean

clips ile, bunlar tek bir dosyada birleştirilir — video, audio_only, both, short, nosound.

Idempotency-Key

header

HTTP header (≤ 200 karakter) olarak gönderilir, body alanı olarak değil — yeniden denemeler aynı işi kullanır.

Uç noktalar: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Bearer ile kimlik doğrulanır.
GET /v1/download/{token}/{file} — URL token'ıyla doğrulanır, Bearer header'ı yok.

Fiyatlandırma

Kullanıcı başına değil, klip başına ödeyin.

Ön ödemeli krediler AppsGolem kesme API'sini & MCP sunucusunu çalıştırır — üretilen her klip bir kredidir ve başarısız kesimler asla faturalandırılmaz. Ara sıra kullanım için bir paket satın alın veya düzenli aylık hacim ve daha yüksek hız limiti için abone olun.

№ 01 / Ön ödemeli paketler