Izstrādātāju API · MCP serveris

Apgriez YouTube klipus no sava koda.

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

Vienkārša REST API un MCP serveris AI aģentiem — viss, ko dara tīmekļa griezējs, programmatiski. Priekšapmaksas kredīti, bez abonementa.

Iegūt API atslēgu Ātrais sākums

API + MCP kodēšanas aģentiem →

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

Kā tas darbojas

Pirmo reizi šeit? Viss modelis vienā minūtē.

Tu nopērc priekšapmaksātus kredītus, izveido API atslēgu un izsauc vienu galapunktu, lai izgrieztu klipu. Griešana ir asinhrona: tu iesniedz uzdevumu, aptaujā, līdz tas ir sagatavots, tad lejupielādē failu no tokenizēta URL. MCP serveris to visu ietver vienā rīka izsaukumā AI aģentiem. Bez abonementa, bez vietām — tu maksā par katru sagatavoto klipu.

1 · Autentificēties

Sūti savu atslēgu kā Authorization: Bearer ag_live_… katrā pieprasījumā.

2 · Iesniegt un aptaujāt

POST /v1/cuts atgriež darba id; aptaujā GET /v1/cuts/{id}, līdz tas ir sagatavots.

3 · Lejupielādēt

Iegūsti download_url no sagatavotā darba — galvene nav vajadzīga, jo to autorizē pats tokens.

Ātrais sākums

No nulles līdz klipam četros izsaukumos.

01

Izveidot API atslēgu

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

Iesniegt apgriešanu

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

Aptaujāt lejupielādes URL

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

Statusi mainās šādi: accepted → queued → produced → delivered (vai failed → refunded). Īss klips parasti ir gatavs dažu sekunžu laikā; aptaujā ik pēc 3–5 s.

Lejupielādes saites ir derīgas 72 stundas pēc klipa izveides — lejupielādējiet to šajā laika periodā.

04

Lejupielādēt klipu

Tokenizētais URL straumē MP4 failu — to var izmantot atkārtoti, līdz tas kļūst nederīgs. MCP rīks cut_youtube_video tavā vietā paveic soļus 2–4 vienā izsaukumā.

AI aģentiem · MCP

Viena rinda priekš Claude, Cursor un Codex.

MCP serveris padara griezēju pieejamu kā trīs rīkus, ko var izsaukt jebkurš MCP klients. Instalē ar npx — nekas nav jāinstalē globāli.

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

Iesniedz apgriešanu (jebkurš režīms, opcijas vai klipu masīvs) un saņem atpakaļ lejupielādes URL.

get_cut_status()

Pārbaudi uzdevumu pēc id un iegūsti tā lejupielādes URL.

get_account_balance()

Jūsu pieejamie kredīti un stundas limits.

Ko teikt savam aģentam — visas iespējas

“Izgriez video daļu no 0:30 līdz 1:15 1080p kvalitātē”

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

“Izvelc šī video audio no 2:00–5:00 kā 320 kbps MP3”

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

“Eksportē video un pirmo 30 sekunžu MP3”

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

“Izveido 9:16 vertikālu īsfilmiņu no 10:00–10:45 spilgtākā brīža”

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

“Pārvērt 0:05–0:12 par GIF”

cut_youtube_video(…, mode="gif")

“Izveido kadru contact sheet ik pēc 5 sekundēm no 1:00–2:00”

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

“Stitch 0:10–0:20 un 1:00–1:10 kopā vienā klipā”

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

“Izveido fast, stream-copy tipa griezumu no pirmajām 30 sekundēm”

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

“Izgriez 0:00–0:20 ar 1.5× ātrumu, 4K kvalitātē”

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

“Cik API kredītu man vēl ir palicis?”

get_account_balance()

“Pārbaudi darba e48d…b1a2 statusu”

get_cut_status(job_id="e48d…b1a2")

Aģents pats aizpilda parametrus no tava pieprasījuma — tev nav jāraksta JSON.

API atsauce

Katrs galapunkts ar piemēriem.

Četri galapunkti. Trīs lasīšanas/rakstīšanas galapunkti pieprasa Authorization: Bearer <key>; lejupielādes URL autorizē tā paša tokens, tāpēc galvene nav vajadzīga.

POST /v1/cuts Bearer

Pieprasījums · video

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

Atbilde · 202 Accepted

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

Norādi vai nu start+end, vai clips masīvu (1–10 intervāli). Pievieno Idempotency-Key galveni (≤200 rakstzīmes), lai atkārtots pieprasījums izmantotu to pašu darbu, nevis tiktu apmaksāts divreiz.

Pieprasījuma pamatteksts pēc režīma

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 arhīvā

{ "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, bez skaņas

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

gif≤ 5 min, viens klips

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

framesJPG kadri · ≤ 1800

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

clips + stitch1–10 → viens fails

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

Atbilde · 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 ir viens no: accepted · queued · produced · delivered · failed · refunded. download_url parādās, tiklīdz tokens ir gatavs — ja tā nav, aptaujā vēlreiz.

GET /v1/account Bearer

Atbilde · 200

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

GET /v1/download/{token}/{file} Tokens URL adresē

Atbilde · 200

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

Bearer galvene nav vajadzīga — to autorizē tokens ceļā. URL var izmantot atkārtoti, līdz tas beidzas.

Kļūdas

Katra kļūme atgriež JSON saturu ar error kodu un HTTP statusu. Atkārto 429 pēc retry_after sekundēm; ja saņem 400, izlabo un iesniedz vēlreiz.

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

Pieprasījumu limits: Ātruma ierobežojums attiecas tikai uz griešanas iesniegumiem — iesniegumu skaits stundā ir atkarīgs no jūsu plāna (skatiet Cenas). Uzdevuma progresa pārbaude parastā lietošanā netiek ierobežota, tāpēc periodiska statusa aptaujāšana nekad netiek ieskaitīta šajā limitā. Katrā atbildē ievērojiet vērtību poll_after (un retā 429 kļūdas gadījumā — galveni Retry-After); MCP rīks to jūsu vietā automātiski regulē, izmantojot wait=true.

Iespējas

Visi tīmekļa griezēja režīmi.

MODE video

MP4 līdz pat 4K

144p–2160p, 60fps, bez ūdenszīmes.

MODE audio_only

Audio

mp3 / m4a / wav / flac, izvēlams bitreits.

MODE both

Video + audio

MP4 un MP3 kopā, zip failā.

MODE nosound

Video bez skaņas

Video bez skaņas celiņa.

MODE short

9:16 vertikāli

AI viedā apgriešana Shorts, Reels un TikTok vajadzībām; ja tas nav pieejams, tiek izmantotas izpludinātas joslas.

MODE gif

Animēts GIF

Līdz 5 minūtēm, tieši no klipa.

MODE frames

JPG kadri

Ik pēc 100ms–10s, laika zīmogi + kontaktlapa.

OPTION fast

Ātrais režīms

Stream-copy, aptuveni 10× ātrāk; saglabā avota konteineru (WebM ar 1440p/2160p).

OPTION speed

Ātrums 0.5–2×

Maina atskaņošanas ātrumu eksportējot.

OPTION clips

Vairāku klipu apvienošana

Līdz 10 posmiem, apvienoti vienā failā.

Atsauce

Parametri

Lauks

Veids

Piezīmes

url

string

YouTube watch / share / youtu.be URL.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Izlaid, ja izmanto klipus.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; kopējais apgriešanas ilgums ≤ 60 min).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — tikai audio_only režīmam; both vienmēr ir MP3.

bitrate

enum

Zudumu bitu ātrums 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); neattiecas uz wav/flac.

fast

boolean

Straumes kopēšana, apmēram 10× ātrāk — tikai video, nosound, both; piespiež ātrumu uz 1×.

speed

number

Atskaņošanas ātrums 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Kadru atlase: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG kopā.

burn_ts

boolean

Kadri — iededzina avota laika zīmogu katrā JPG.

sheet

boolean

Kadri — viens kontaktlapas JPG fails (viens klips); atspējo burn_ts.

clips

array

1–10 {start,end} posmi; iestati stitch, lai apvienotu tos vienā failā.

stitch

boolean

Izmantojot clips, apvienojiet tos vienā failā — video, audio_only, both, short, nosound.

Idempotency-Key

header

Nosūtīts kā HTTP galvene (≤ 200 rakstzīmes), nevis pamatteksta lauks — atkārtoti mēģinājumi izmanto to pašu uzdevumu.

Galapunkti: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Autentificēts ar Bearer.
GET /v1/download/{token}/{file} — autentificēts ar URL marķieri, bez Bearer galvenes.

Cenas

Maksā par klipiem, nevis lietotājiem.

Priekšapmaksātie kredīti darbina AppsGolem griešanas rīka API & MCP serveri — viens izveidots fragments ir viens kredīts, un neveiksmīgi griezumi nekad netiek iekasēti. Pērciet paketi neregulārai lietošanai vai abonējiet stabilu ikmēneša apjomu un augstāku ātruma limitu.

№ 01 / Iepriekš apmaksātas paketes