有人在巴西剪輯了一支18秒的片段 4分鐘前

已有 201442 個片段透過 AppsGolem 剪輯完成。

開發者 API · MCP 伺服器

直接從你的程式碼剪輯 YouTube 影片片段。

一個簡單的 REST API，以及供 AI 代理程式使用的 MCP 伺服器 — 網頁剪輯工具能做的一切，都能以程式化方式完成。預付點數，無需訂閱。

取得 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金鑰,呼叫一個端點來剪片。剪片是非同步的:你送出工作、輪詢直到產出完成,再從帶權杖的URL下載檔案。MCP伺服器把這整套流程包裝成給AI代理使用的單一工具呼叫。沒有訂閱、沒有席位 — 只依產出的片段計費。

1 · 驗證身分
每個請求都以Authorization: Bearer ag_live_…的形式傳送你的金鑰。
2 · 送出並輪詢
POST /v1/cuts會回傳工作ID;輪詢GET /v1/cuts/{id}直到產出完成。
3 · 下載
從已產出的工作取得download_url — 不需要標頭,權杖本身就能授權。
快速入門

四次呼叫，從零開始產生剪輯片段。

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"}'
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秒輪詢一次。
下載連結會在剪輯產生後 72 小時失效,請在期限內下載。
04
下載剪輯片段
此權杖化 URL 會串流傳輸 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()
提交剪輯要求（任何模式、選項，或 clips 陣列），即可取得回傳的下載 URL。
get_cut_status()
依 id 查詢任務，並取得其下載 URL。
get_account_balance()
您可用的點數與每小時上限。
該對你的代理說什麼 — 所有功能一次看
“將影片0:30到1:15的片段以1080p剪出”
cut_youtube_video(url, start="0:30", end="1:15", resolution="1080p")
“擷取該影片2:00–5:00的音訊,存成320 kbps的MP3”
cut_youtube_video(…, mode="audio_only", audio_format="mp3", bitrate="320")
“匯出前30秒的影片和MP3”
cut_youtube_video(…, end="0:30", mode="both")
“把10:00–10:45的精華片段做成9:16直式短片”
cut_youtube_video(…, start="10:00", end="10:45", mode="short")
“把0:05–0:12轉成GIF”
cut_youtube_video(…, mode="gif")
“從1:00–2:00每5秒擷取一張畫面,製成contact sheet”
cut_youtube_video(…, mode="frames", interval_ms=5000, sheet=true)
“把0:10–0:20和1:00–1:10 stitch成一支影片”
cut_youtube_video(url, clips=[…], stitch=true)
“以fast, 串流複製的方式剪出前30秒”
cut_youtube_video(…, end="0:30", fast=true)
“以1.5×速度、4K畫質剪出0:00–0:20”
cut_youtube_video(…, speed=1.5, resolution="2160p")
“我還剩多少API額度?”
get_account_balance()
“查詢工作 e48d…b1a2 的狀態”
get_cut_status(job_id="e48d…b1a2")
代理會從你的請求中自動填入參數 — 你不必自己寫JSON。
API參考文件

每個端點都附有範例。

共四個端點。三個讀寫端點都需要Authorization: Bearer <key>;下載URL則由自身的權杖授權,因此不需要標頭。

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個區間)。加上Idempotency-Key標頭(≤200字元),讓重試的請求能重用同一個工作,而不會被重複收費。
各模式的請求內文
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智慧裁切
{ "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會在權杖就緒後出現 — 若還沒出現,請再次輪詢。
GET /v1/account Bearer
回應 · 200
{ "balance": 412, "hourly_cap": 60 }
GET /v1/download/{token}/{file} URL中的權杖
回應 · 200
# streams the file
Content-Type: video/mp4
Content-Disposition: attachment; filename="clip.mp4"
不需要Bearer標頭 — 路徑中的權杖就能授權。此URL在過期前可重複使用。
錯誤

每次失敗都會回傳含有error代碼與HTTP狀態的JSON內容。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
速率限制: 只有裁切提交會受到速率限制 — 依你的方案每小時可提交次數而定（請參閱定價）。查詢工作進度在一般使用情況下不受速率限制，因此輪詢不會計入該上限。請遵守每個回應中的poll_after（在少見的 429 情況下也請遵守Retry-After）；MCP 工具會透過wait=true自動為你控制節奏。
功能

網頁剪輯工具的所有模式。

MODE video
最高 4K 的 MP4
144p–2160p，60fps，無浮水印。
MODE audio_only
音訊
mp3 / m4a / wav / flac，可選擇位元率。
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×;保留原始容器格式(1440p/2160p 為 WebM)。
OPTION speed
速度 0.5–2×
匯出時重新調整播放速度。
OPTION clips
多剪輯片段拼接
最多可將 10 個時間區間合併成一個檔案。
參考文件

參數

欄位
類型
備註
url
string
YouTube 的觀看 / 分享 / youtu.be URL。
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 (單一 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} — 以 URL 權杖驗證，不使用 Bearer 標頭。
定價

依剪輯片段付費，而非依席位付費。

預付點數為 AppsGolem 剪輯 API & MCP 伺服器提供動力——每產出一個片段即消耗 1 點數,失敗的剪輯絕不收費。偶爾使用可購買點數包,穩定的每月用量則建議訂閱以取得更高的速率限制。

№ 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  /  點數運作方式

剪輯費用說明。

  • 標準片段 (最高 1080p;純音訊則不限解析度)1 點數
  • 4K (2160p) 影片片段4 點數
  • 來源長度超過 2 小時 (已知時)+1 / 工作
  • 批次處理 N 個片段 (打包 zip 或合併)N × 每個片段

計算範例

從一段 25 分鐘影片剪出三個 1080p 精華片段 + 一個 4K 片段 → 3×1 + 4 = 7 credits。

將一集 3 小時的 Podcast 剪成一個 MP3 → 1 + 1 = 2 credits(+1 為 >2 h 附加費)。

№ 04  /  FAQ

須知事項。

什麼是點數?

每產出一個片段 = 1 點數。4K 片段為 4 點數,批次處理則依片段數量倍增。

點數會過期嗎?

點數包的點數效期為 12 個月。訂閱點數僅在發放當期的計費週期內有效。

每小時請求數上限是多少?

指每小時可送出的 API 呼叫次數。點數包維持預設的 30 次;Pro 提升至 60 次,Scale 提升至 120 次。

我可以隨時取消嗎?

可以。訂閱只需點一下即可取消;已發放的點數會保留至到期為止。

如果剪輯失敗怎麼辦?

失敗的剪輯絕不收費——只要點數仍在有效期內,預留的點數會自動退還。

我可以同時使用點數包與訂閱方案嗎?

可以。點數包與訂閱點數可疊加使用;系統一律優先扣除最早到期的點數。