API สำหรับนักพัฒนา · เซิร์ฟเวอร์ MCP

ตัดคลิป YouTube จากโค้ดของคุณ

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

REST API และเซิร์ฟเวอร์ MCP ที่เรียบง่ายสำหรับ AI agent — ทำทุกอย่างที่เว็บตัดคลิปทำได้ด้วยโค้ดของคุณเอง เครดิตแบบเติมเงินล่วงหน้า ไม่มีการสมัครสมาชิก

รับ API key เริ่มต้นใช้งานอย่างรวดเร็ว

API + MCP สำหรับ coding agent →

# 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 key แล้วเรียกใช้ endpoint เดียวเพื่อตัดคลิป การตัดคลิปเป็นแบบอะซิงโครนัส: คุณส่ง job แล้ว poll ไปเรื่อย ๆ จนกว่าจะสร้างเสร็จ จากนั้นดาวน์โหลดไฟล์จาก URL ที่มี token กำกับ เซิร์ฟเวอร์ MCP รวมขั้นตอนทั้งหมดนี้ไว้ในการเรียกใช้เครื่องมือเพียงครั้งเดียวสำหรับ AI agent ไม่ต้องสมัครสมาชิก ไม่ต้องมีที่นั่ง — จ่ายเฉพาะต่อคลิปที่สร้างเสร็จเท่านั้น

1 · ยืนยันตัวตน

ส่งคีย์ของคุณในรูปแบบ Authorization: Bearer ag_live_… ในทุกคำขอ

2 · ส่ง & ตรวจสอบสถานะ

POST /v1/cuts จะคืนค่า job id มา; ตรวจสอบสถานะด้วย GET /v1/cuts/{id} จนกว่าจะสร้างเสร็จ

3 · ดาวน์โหลด

ดึง download_url จาก job ที่สร้างเสร็จแล้ว — ไม่ต้องใช้ header เพราะ token เป็นตัวยืนยันสิทธิ์อยู่แล้ว

เริ่มต้นใช้งานอย่างรวดเร็ว

จากศูนย์สู่คลิปใน 4 การเรียกใช้งาน

01

สร้าง API key

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 s

ลิงก์ดาวน์โหลดจะหมดอายุ 72 ชั่วโมงหลังจากสร้างคลิป — กรุณาดาวน์โหลดภายในระยะเวลาดังกล่าว

04

ดาวน์โหลดคลิป

URL ที่มีโทเคนจะสตรีม MP4 — ใช้ซ้ำได้จนกว่าจะหมดอายุ เครื่องมือ MCP อย่าง cut_youtube_video จะทำขั้นตอนที่ 2–4 ให้คุณในการเรียกครั้งเดียว

สำหรับ AI agent · MCP

หนึ่งบรรทัดสำหรับ Claude, Cursor & Codex

เซิร์ฟเวอร์ MCP เปิดให้ใช้งานตัวตัดคลิปเป็นเครื่องมือ 3 ตัวที่ MCP client ใดก็ตามสามารถเรียกใช้ได้ ติดตั้งด้วย npx — ไม่ต้องติดตั้งอะไรแบบ global

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

ส่งคำขอตัดคลิป (เลือกโหมด ตัวเลือกใดก็ได้ หรือส่ง clips array) แล้วรับ 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)

“ตัด 30 วินาทีแรกแบบ fast แบบ stream-copy”

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

“ตรวจสอบสถานะ job e48d…b1a2”

get_cut_status(job_id="e48d…b1a2")

agent จะกรอกพารามิเตอร์ให้จากคำขอของคุณ — คุณไม่ต้องเขียน JSON เอง

เอกสารอ้างอิง API

ทุก endpoint พร้อมตัวอย่าง

มีทั้งหมดสี่ endpoint โดยสาม endpoint สำหรับอ่าน/เขียนต้องใช้ 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 หรือ array ของ clips (1–10 ช่วง) เพิ่ม header Idempotency-Key (≤200 ตัวอักษร) เพื่อให้คำขอที่ส่งซ้ำใช้ job เดิม แทนที่จะถูกเรียกเก็บเงินสองครั้ง

เนื้อหาคำขอตามแต่ละโหมด

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 smart-crop ด้วย 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" }

framesภาพนิ่ง JPG · ≤ 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 พร้อมใช้งาน — หากยังไม่มี ให้ตรวจสอบสถานะอีกครั้ง

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 ที่อยู่ใน path เป็นตัวยืนยันสิทธิ์อยู่แล้ว URL นี้ใช้ซ้ำได้จนกว่าจะหมดอายุ

ข้อผิดพลาด

ทุกความล้มเหลวจะคืนค่าเป็น JSON body พร้อมรหัส error และสถานะ HTTP ลองใหม่สำหรับ 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; หากใช้งานไม่ได้จะสลับไปใช้แถบขอบเบลอ (letterbox) แทน

MODE gif

GIF เคลื่อนไหว

สูงสุด 5 นาที ตัดออกมาจากคลิปได้โดยตรง

MODE frames

เฟรมภาพ JPG

ทุก 100ms–10s พร้อม timestamp + contact sheet

OPTION fast

โหมดเร็ว

ใช้การสตรีมคัดลอก เร็วขึ้นประมาณ 10×; คงคอนเทนเนอร์ต้นฉบับไว้ (WebM ที่ 1440p/2160p)

OPTION speed

ความเร็ว 0.5–2×

ปรับความเร็วการเล่นวิดีโอเมื่อ export

OPTION clips

การต่อหลายคลิปเข้าด้วยกัน

รวมช่วงเวลาสูงสุด 10 ช่วงเข้าเป็นไฟล์เดียว

ข้อมูลอ้างอิง

พารามิเตอร์

ฟิลด์

ประเภท

หมายเหตุ

url

string

URL แบบ YouTube watch / share / youtu.be

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h) ไม่ต้องระบุหากใช้ clips

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 เท่านั้น; บังคับ speed เป็น 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 แบบ contact sheet เพียงภาพเดียว (คลิปเดียว); ปิดใช้งาน burn_ts

clips

array

ช่วงเวลา {start,end} 1–10 ช่วง ตั้งค่า stitch เพื่อรวมเป็นไฟล์เดียว

stitch

boolean

เมื่อใช้ clips จะรวมเป็นไฟล์เดียว — video, audio_only, both, short, nosound

Idempotency-Key

header

ส่งเป็น HTTP header (≤ 200 ตัวอักษร) ไม่ใช่ฟิลด์ใน body — การลองใหม่จะใช้งานเดิมซ้ำ

Endpoints: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — ยืนยันตัวตนด้วย Bearer
GET /v1/download/{token}/{file} — ยืนยันตัวตนด้วยโทเคนที่อยู่ใน URL ไม่มี Bearer header

ราคา

จ่ายตามคลิป ไม่ใช่ตามที่นั่งผู้ใช้งาน

เครดิตแบบเติมเงินล่วงหน้าขับเคลื่อน API เครื่องมือตัดคลิป & เซิร์ฟเวอร์ MCP ของ AppsGolem — คลิปที่สร้างสำเร็จ 1 คลิป เท่ากับ 1 เครดิต และการตัดที่ล้มเหลวจะไม่ถูกเรียกเก็บเงินเลย ซื้อแพ็กสำหรับการใช้งานเป็นครั้งคราว หรือสมัครสมาชิกสำหรับปริมาณการใช้งานที่สม่ำเสมอทุกเดือนพร้อมขีดจำกัดอัตราที่สูงขึ้น

№ 01 / แพ็กเติมเงินล่วงหน้า