API προγραμματιστών · διακομιστής MCP

Κόψτε κλιπ YouTube από τον κώδικά σας.

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

Ένα απλό REST API και ένας διακομιστής MCP για πράκτορες AI — ό,τι κάνει το εργαλείο κοπής, προγραμματιστικά. Προπληρωμένες πιστώσεις, χωρίς συνδρομή.

Απόκτηση κλειδιού 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 και καλείτε ένα endpoint για να κόψετε ένα κλιπ. Η κοπή είναι ασύγχρονη: υποβάλλετε μια εργασία, κάνετε poll μέχρι να παραχθεί, και μετά κατεβάζετε το αρχείο από ένα URL με token. Ο διακομιστής MCP συγκεντρώνει όλα αυτά σε μία κλήση εργαλείου για AI agents. Χωρίς συνδρομή, χωρίς θέσεις χρήστη — πληρώνετε ανά παραγόμενο κλιπ.

1 · Έλεγχος ταυτότητας

Στείλτε το κλειδί σας ως Authorization: Bearer ag_live_… σε κάθε αίτημα.

2 · Υποβολή & poll

Το POST /v1/cuts επιστρέφει ένα id εργασίας; κάντε poll στο GET /v1/cuts/{id} μέχρι να παραχθεί.

3 · Λήψη

Ανακτήστε το download_url από την παραγόμενη εργασία — δεν χρειάζεται header, το token την εξουσιοδοτεί.

Γρήγορη εκκίνηση

Από το μηδέν σε ένα κλιπ με τέσσερις κλήσεις.

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

Κάντε poll για το 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). Ένα σύντομο κλιπ είναι συνήθως έτοιμο μέσα σε δευτερόλεπτα; κάντε poll κάθε 3–5 s.

Οι σύνδεσμοι λήψης λήγουν 72 ώρες μετά τη δημιουργία του κλιπ — κατεβάστε το εντός αυτού του χρονικού διαστήματος.

04

Κατεβάστε το κλιπ

Το URL με token μεταδίδει το 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()

Ελέγξτε μια εργασία με βάση το id και ανακτήστε το URL λήψης της.

get_account_balance()

Οι διαθέσιμες πιστώσεις σας και το ωριαίο όριο.

Τι να πείτε στον agent σας — κάθε δυνατότητα

“Κόψτε ένα βίντεο από 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")

“Εξαγάγετε ένα contact 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")

Ο agent συμπληρώνει τις παραμέτρους από το αίτημά σας — δεν χρειάζεται να γράψετε JSON.

Αναφορά API

Κάθε endpoint, με παραδείγματα.

Τέσσερα endpoints. Τα τρία endpoints ανάγνωσης/εγγραφής χρησιμοποιούν Authorization: Bearer <key>; το URL λήψης εξουσιοδοτείται από το δικό του token, οπότε δεν χρειάζεται header.

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 παράθυρα). Προσθέστε ένα header Idempotency-Key (≤200 χαρακτήρες) ώστε ένα επαναλαμβανόμενο αίτημα να επαναχρησιμοποιεί την ίδια εργασία αντί να χρεώνεται δύο φορές.

Σώμα αιτήματος ανά mode

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

short9:16 AI smart-crop

{ "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 εμφανίζεται μόλις είναι έτοιμο ένα token — αν λείπει, κάντε poll ξανά.

GET /v1/account Bearer

Απόκριση · 200

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

GET /v1/download/{token}/{file} Token στο URL

Απόκριση · 200

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

Χωρίς header Bearer — το token στη διαδρομή το εξουσιοδοτεί. Το URL είναι επαναχρησιμοποιήσιμο μέχρι να λήξει.

Σφάλματα

Κάθε αποτυχία επιστρέφει ένα σώμα JSON με έναν κωδικό error και το HTTP status. Επαναλάβετε το 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, επιλέξιμο bitrate.

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

Γρήγορη λειτουργία

Αντιγραφή ροής, περίπου 10× ταχύτερη· διατηρεί τον αρχικό περιέκτη (WebM σε 1440p/2160p).

OPTION speed

Ταχύτητα 0.5–2×

Προσαρμογή του ρυθμού αναπαραγωγής κατά την εξαγωγή.

OPTION clips

Συρραφή πολλαπλών κλιπ

Έως 10 παράθυρα ενωμένα σε ένα αρχείο.

Αναφορά

Παράμετροι

Πεδίο

Τύπος

Σημειώσεις

url

string

URL YouTube watch / share / 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

Bitrate με απώλειες 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 φύλλου επαφών (ένα clip); απενεργοποιεί το 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} — πιστοποίηση μέσω του token της URL, χωρίς κεφαλίδα Bearer.

Τιμές

Πληρώστε για κλιπ, όχι για θέσεις.

Οι προπληρωμένες πιστώσεις τροφοδοτούν το API κοπής βίντεο του AppsGolem & τον διακομιστή MCP — ένα ολοκληρωμένο κλιπ ισούται με μία πίστωση, και οι αποτυχημένες κοπές δεν χρεώνονται ποτέ. Αγοράστε ένα πακέτο για περιστασιακή χρήση ή εγγραφείτε σε συνδρομή για σταθερό μηνιαίο όγκο και υψηλότερο όριο αιτημάτων.

№ 01 / Προπληρωμένα πακέτα

Πληρώστε ανάλογα με τη χρήση.

Εφάπαξ αγορά, χωρίς ανανέωση. Οι πιστώσεις παραμένουν έγκυρες για 12 μήνες.

Βασικό πακέτο

€5 εφάπαξ

25 πιστώσεις · ≈ 25 τυπικά κλιπ

Έγκυρο για 12 μήνες

Ξεκινήστε

Πακέτο PAYG Καλύτερη αξία

€25 εφάπαξ

150 πιστώσεις · ≈ 150 τυπικά κλιπ

Έγκυρο για 12 μήνες · €0,17 / πίστωση

Ξεκινήστε

№ 02 / Συνδρομές

Κόβετε κάθε μήνα.

Οι πιστώσεις ανανεώνονται κάθε περίοδο και το όριο αιτημάτων σας αυξάνεται. Ακύρωση όποτε θέλετε.

Βασικό

€19 / μήνα

ή €190 / έτος · 2 μήνες δωρεάν

250 πιστώσεις / μήνα

30 αιτήματα / ώρα
Οι πιστώσεις ανανεώνονται μηνιαίως
Ακύρωση όποτε θέλετε

Ξεκινήστε

★ Πιο δημοφιλές Pro

€49 / μήνα

ή €490 / έτος · 2 μήνες δωρεάν

1000 πιστώσεις / μήνα

60 αιτήματα / ώρα
Οι πιστώσεις ανανεώνονται μηνιαίως
Ακύρωση όποτε θέλετε

Ξεκινήστε

Ανάπτυξη

€149 / μήνα

ή €1490 / έτος · 2 μήνες δωρεάν

5000 πιστώσεις / μήνα

120 αιτήματα / ώρα
Οι πιστώσεις ανανεώνονται μηνιαίως
Ακύρωση όποτε θέλετε

Ξεκινήστε

Οι συνδρομές χορηγούν τις πιστώσεις όλης της περιόδου εκ των προτέρων και αυξάνουν το όριο αιτημάτων σας ανά ώρα. Τα ετήσια πλάνα χρεώνονται για 10 μήνες αντί για 12.

№ 03 / Πώς λειτουργούν οι πιστώσεις