Kehittäjä-API · MCP-palvelin

Leikkaa YouTube-klippejä koodistasi.

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

Yksinkertainen REST-API ja MCP-palvelin AI-agenteille — kaikki, mitä verkkopohjainen leikkuri tekee, ohjelmallisesti. Ennakkoon maksetut krediitit, ei tilausta.

Hanki API-avain Pika-aloitus

API + MCP koodausagenteille →

# 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"}'

Näin se toimii

Ensi kertaa täällä? Koko malli minuutissa.

Ostat ennakkoon maksettuja krediittejä, luot API-avaimen ja kutsut yhtä päätepistettä klipin leikkaamiseksi. Leikkaus on asynkronista: lähetät työn, kyselet tilaa, kunnes se on valmis, ja lataat sitten tiedoston tokenisoidusta URL-osoitteesta. MCP-palvelin pakkaa kaiken tämän yhdeksi työkalukutsuksi tekoälyagenteille. Ei tilausta, ei käyttäjäpaikkoja — maksat jokaisesta valmiiksi tuotetusta klipistä.

1 · Todennus

Lähetä avaimesi muodossa Authorization: Bearer ag_live_… jokaisessa pyynnössä.

2 · Lähetys ja kysely

POST /v1/cuts palauttaa työn id:n; kyselet osoitteesta GET /v1/cuts/{id}, kunnes se on valmis.

3 · Lataa

Hae download_url valmiiksi tuotetulta työltä — otsaketta ei tarvita, koska token itsessään valtuuttaa sen.

Pika-aloitus

Nollasta klippiin neljällä kutsulla.

01

Luo API-avain

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

Lähetä leikkaus

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

Kysele latauksen URL-osoitetta

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

Tilat etenevät näin: accepted → queued → produced → delivered (tai failed → refunded). Lyhyt klipi on yleensä valmis muutamassa sekunnissa; kysele 3–5 s välein.

Latauslinkit vanhenevat 72 tuntia klipin valmistumisen jälkeen — nouda se tämän ajan kuluessa.

04

Lataa klippi

Tokenisoitu URL suoratoistaa MP4:n — uudelleenkäytettävissä, kunnes se vanhenee. MCP-työkalu cut_youtube_video hoitaa vaiheet 2–4 puolestasi yhdellä kutsulla.

AI-agenteille · MCP

Yksi rivi Claudelle, Cursorille ja Codexille.

MCP-palvelin tarjoaa leikkurin kolmena työkaluna, joita mikä tahansa MCP-asiakas voi kutsua. Asenna komennolla npx — mitään ei tarvitse asentaa globaalisti.

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

Lähetä leikkaus (mikä tahansa tila, valinnat tai clips-taulukko) ja saat takaisin latauksen URL-osoitteen.

get_cut_status()

Tarkista työ id:n perusteella ja hae sen latauksen URL-osoite.

get_account_balance()

Käytettävissä olevat krediittisi ja tuntikohtainen yläraja.

Mitä sanoa agentillesi — kaikki ominaisuudet

“Leikkaa video kohdasta 0:30 kohtaan 1:15 laadulla 1080p”

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

“Nappaa tuon videon ääni väliltä 2:00–5:00 320 kbps MP3:na”

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

“Vie video ja MP3 ensimmäisistä 30 sekunnista”

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

“Tee 9:16-pystyvideo kohokohdasta 10:00–10:45”

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

“Muuta 0:05–0:12 GIF-kuvaksi”

cut_youtube_video(…, mode="gif")

“Tee contact sheet -kuvat 5 sekunnin välein väliltä 1:00–2:00”

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

“Stitch 0:10–0:20 ja 1:00–1:10 yhdeksi klipiksi”

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

“Tee fast, stream-copy-tyyppinen leikkaus ensimmäisistä 30 sekunnista”

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

“Leikkaa 0:00–0:20 nopeudella 1.5×, laadulla 4K”

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

“Kuinka monta API-krediittiä minulla on jäljellä?”

get_account_balance()

“Tarkista työn e48d…b1a2 tila”

get_cut_status(job_id="e48d…b1a2")

Agentti täyttää parametrit pyyntösi perusteella — sinun ei tarvitse kirjoittaa JSONia.

API-referenssi

Jokainen päätepiste esimerkkeineen.

Neljä päätepistettä. Kolme luku-/kirjoituspäätepistettä vaatii otsakkeen Authorization: Bearer <key>; latausosoitteen valtuuttaa sen oma token, joten se ei tarvitse otsaketta.

POST /v1/cuts Bearer

Pyyntö · video

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

Vastaus · 202 Accepted

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

Anna joko start+end tai clips-taulukko (1–10 aikaväliä). Lisää Idempotency-Key-otsake (≤200 merkkiä), jotta uudelleenlähetetty pyyntö käyttää samaa työtä sen sijaan, että sinulta veloitettaisiin kahdesti.

Pyynnön runko tilan mukaan

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-paketissa

{ "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, ei ääntä

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

gif≤ 5 min, yksi klipi

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

framesJPG-pysäytyskuvat · ≤ 1800

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

clips + stitch1–10 → yksi tiedosto

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

Vastaus · 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 on jokin näistä: accepted · queued · produced · delivered · failed · refunded. download_url ilmestyy, kun token on valmis — jos sitä ei ole, kysele uudelleen.

GET /v1/account Bearer

Vastaus · 200

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

GET /v1/download/{token}/{file} Token URL:ssa

Vastaus · 200

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

Ei Bearer-otsaketta — polussa oleva token valtuuttaa sen. URL-osoitetta voi käyttää uudelleen, kunnes se vanhenee.

Virheet

Jokainen epäonnistuminen palauttaa JSON-rungon, jossa on error-koodi ja HTTP-tila. Yritä 429 uudelleen retry_after sekunnin kuluttua; korjaa ja lähetä uudelleen, jos saat 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

Pyyntörajoitus: Vain leikkauksen lähetykset ovat nopeusrajoitettuja — pakettisi lähetystä/tunti (katso Hinnoittelu). Työn edistymisen tarkistaminen ei ole nopeusrajoitettua normaalikäytössä, joten kyselyt eivät koskaan kuluta tätä rajaa. Noudata poll_after-arvoa jokaisessa vastauksessa (ja Retry-After-arvoa harvinaisessa 429-virheessä); MCP-työkalu tahdittaa tämän puolestasi, kun käytät wait=true.

Ominaisuudet

Kaikki verkkopohjaisen leikkurin tilat.

MODE video

MP4, jopa 4K

144p–2160p, 60fps, ei vesileimaa.

MODE audio_only

Ääni

mp3 / m4a / wav / flac, valittava bittinopeus.

MODE both

Video + ääni

MP4 ja MP3 yhdessä, zip-tiedostona.

MODE nosound

Mykistetty video

Video ilman äänirataa.

MODE short

9:16 pysty

AI:n älykäs rajaus Shorts-, Reels- ja TikTok-videoihin; jos toiminto ei ole käytettävissä, käytetään sumennettuja palkkeja.

MODE gif

Animoitu GIF

Enintään 5 minuuttia, suoraan klipistä.

MODE frames

JPG-ruudut

Joka 100ms–10s, aikaleimat + kontaktivedos.

OPTION fast

Pikatila

Stream-kopiointi, noin 10× nopeampi; säilyttää lähteen säiliömuodon (WebM 1440p/2160p-resoluutiolla).

OPTION speed

Nopeus 0.5–2×

Säätää toistonopeutta viennin yhteydessä.

OPTION clips

Usean klipin yhdistäminen

Enintään 10 osuutta yhdistettynä yhdeksi tiedostoksi.

Viiteopas

Parametrit

Kenttä

Tyyppi

Huomiot

url

string

YouTube watch-, share- tai youtu.be-URL.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Jätä pois, jos käytät clips-kenttää.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; leikkauksen kokonaiskesto ≤ 60 min).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — vain tilalle audio_only; both on aina MP3.

bitrate

enum

Häviöllinen bittinopeus 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); ei koske wav/flac.

fast

boolean

Stream-copy, noin 10× nopeampi — vain video, nosound, both; pakottaa nopeuden arvoon 1×.

speed

number

Toistonopeus 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Ruutujen näytteenotto: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; yhteensä ≤ 1800 JPG:tä.

burn_ts

boolean

Ruudut — polttaa lähteen aikaleiman jokaiseen JPG-kuvaan.

sheet

boolean

Ruudut — yksi kontaktivedos-JPG (yksi klippi); poistaa käytöstä burn_ts:n.

clips

array

1–10 {start,end}-osuutta; aseta stitch yhdistämään ne yhdeksi tiedostoksi.

stitch

boolean

Clips-tilassa yhdistetään ne yhdeksi tiedostoksi — video, audio_only, both, short, nosound.

Idempotency-Key

header

Lähetetään HTTP-otsakkeena (≤ 200 merkkiä), ei pyynnön rungon kenttänä — uudelleenyritykset käyttävät samaa tehtävää.

Päätepisteet: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Bearer-todennettu.
GET /v1/download/{token}/{file} — todennettu URL-tokenilla, ei Bearer-otsaketta.

Hinnoittelu

Maksa klipeistä, älä käyttäjäpaikoista.

Ennakkoon ostetut krediitit ovat AppsGolemin leikkuri-API:n & MCP-palvelimen käyttövoima — yksi valmistunut klippi maksaa yhden krediitin, eikä epäonnistuneista leikkauksista koskaan veloiteta. Osta paketti satunnaiseen käyttöön tai tilaa tasainen kuukausittainen määrä ja korkeampi nopeusrajoitus.

№ 01 / Ennakkomaksupaketit

Maksa käytön mukaan.

Kertaostos, ei uusiudu automaattisesti. Krediitit ovat voimassa 12 kuukautta.

Starter-paketti

€5 kertamaksu

25 krediittiä · ≈ 25 vakioklippiä

Voimassa 12 kuukautta

Aloita

PAYG-paketti Paras hinta-laatusuhde

€25 kertamaksu

150 krediittiä · ≈ 150 vakioklippiä

Voimassa 12 kuukautta · €0,17 / krediitti

Aloita

№ 02 / Tilaukset

Leikkaa joka kuukausi.

Krediitit päivittyvät joka jaksolla ja nopeusrajoituksesi nousee. Peruuta milloin tahansa.

Starter

€19 / kk

tai €190 / v · 2 kuukautta ilmaiseksi

250 krediittiä / kuukausi

30 pyyntöä / tunti
Krediitit päivittyvät kuukausittain
Peruuta milloin tahansa

Aloita

★ Suosituin Pro

€49 / kk

tai €490 / v · 2 kuukautta ilmaiseksi

1000 krediittiä / kuukausi

60 pyyntöä / tunti
Krediitit päivittyvät kuukausittain
Peruuta milloin tahansa

Aloita

Scale

€149 / kk

tai €1490 / v · 2 kuukautta ilmaiseksi

5000 krediittiä / kuukausi

120 pyyntöä / tunti
Krediitit päivittyvät kuukausittain
Peruuta milloin tahansa

Aloita

Tilaukset myöntävät koko jakson krediitit etukäteen ja nostavat pyyntöjen/tunti-kattoasi. Vuositilauksissa veloitetaan 10 kuukaudelta 12:n sijaan.

№ 03 / Miten krediitit toimivat

Mitä leikkaus maksaa.

Vakioklippi (enintään 1080p; pelkkä ääni missä tahansa resoluutiossa)1 krediitti
4K (2160p) -videoklippi4 krediittiä
Lähde pidempi kuin 2 h (kun tiedossa)+1 / tehtävä
N klipin erä (zip tai yhdistetty)N × per klippi

Esimerkkilaskelma

Kolme 1080p-kohokohtaa + yksi 4K-klippi 25 minuutin videosta → 3×1 + 4 = 7 credits.

3 tunnin podcast leikattuna yhdeksi MP3-tiedostoksi → 1 + 1 = 2 credits (+1 on >2 h -lisämaksu).

№ 04 / FAQ