브라질의 누군가가 18초짜리 클립을 잘랐습니다 1분 전

AppsGolem으로 201442개의 클립이 잘렸습니다.

개발자 API · MCP 서버

YouTube 클립을 여러분의 코드에서 컷하세요.

AI 에이전트를 위한 간단한 REST API와 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"}'
작동 방식

처음이신가요? 전체 구조를 1분 만에.

선불 크레딧을 구매하고, 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)
“처음 30초를 fast한 스트림 복사 방식으로 잘라줘”
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")
에이전트가 요청 내용에서 파라미터를 채워줍니다 — 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 → 파일 1개
{ "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
MP4 최대 4K
144p–2160p, 60fps, 워터마크 없음.
MODE audio_only
오디오
mp3 / m4a / wav / flac, 비트레이트 선택 가능.
MODE both
영상 + 오디오
MP4와 MP3를 zip으로 함께 제공.
MODE nosound
무음 영상
오디오 트랙이 제거된 동영상.
MODE short
9:16 세로
Shorts, Reels, TikTok을 위한 AI 스마트 크롭; 사용할 수 없는 경우 흐림 레터박싱으로 대체.
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의 watch / share / 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
스트림 복사, 약 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 (클립 1개인 경우); 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개당 1크레딧이며, 실패한 컷은 절대 청구되지 않습니다. 가끔 사용한다면 팩을 구매하고, 매달 꾸준히 사용한다면 구독으로 더 높은 속도 제한을 받으세요.

№ 01  /  선불 팩

사용한 만큼 지불.

일회성 구매이며 자동 갱신되지 않습니다. 크레딧은 12개월간 유효합니다.

Starter팩
€5 일회성

25 크레딧 · ≈ 표준 클립 25개

12개월간 유효

시작하기
PAYG팩 최고의 혜택
€25 일회성

150 크레딧 · ≈ 표준 클립 150개

12개월간 유효 · €0.17 / 크레딧

시작하기

№ 02  /  구독

매달 컷 작업.

크레딧은 매 기간마다 갱신되고 속도 제한도 올라갑니다. 언제든지 해지할 수 있습니다.

Starter
€19 / 월

또는 €190 / 년 · 2개월 무료

250 크레딧 / 월

  • 30 요청 / 시간
  • 크레딧이 매달 갱신됩니다
  • 언제든지 해지 가능
시작하기
★ 가장 인기 Pro
€49 / 월

또는 €490 / 년 · 2개월 무료

1000 크레딧 / 월

  • 60 요청 / 시간
  • 크레딧이 매달 갱신됩니다
  • 언제든지 해지 가능
시작하기
Scale
€149 / 월

또는 €1490 / 년 · 2개월 무료

5000 크레딧 / 월

  • 120 요청 / 시간
  • 크레딧이 매달 갱신됩니다
  • 언제든지 해지 가능
시작하기

구독은 전체 기간의 크레딧을 선지급하고 요청/시간 한도도 높여줍니다. 연간 요금제는 12개월 요금을 10개월치만 청구합니다.

№ 03  /  크레딧 작동 방식

컷 작업 비용.

  • 표준 클립 (최대 1080p, 오디오 전용은 해상도 무관)1크레딧
  • 4K (2160p) 동영상 클립4크레딧
  • 원본이 2시간을 초과하는 경우 (확인 가능한 경우)+1 / 작업
  • N개 클립 일괄 처리 (zip 또는 이어붙이기)N × 클립당

계산 예시

25분 영상에서 1080p 하이라이트 3개 + 4K 클립 1개 → 3×1 + 4 = 7 credits.

3시간짜리 팟캐스트를 MP3 1개로 편집 → 1 + 1 = 2 credits(+1은 >2 h 추가 요금).

№ 04  /  FAQ

알아두면 좋은 정보.

크레딧이란?

생성된 클립 1개 = 1크레딧. 4K 클립은 4크레딧이며, 일괄 처리는 클립 수만큼 곱해집니다.

크레딧이 만료되나요?

팩 크레딧은 12개월간 유효합니다. 구독 크레딧은 지급된 결제 주기 동안만 유효합니다.

요청/시간 한도란 무엇인가요?

시간당 제출할 수 있는 API 호출 수입니다. 팩은 기본값인 30을 유지하며, Pro는 60, Scale은 120으로 올라갑니다.

언제든지 해지할 수 있나요?

네. 구독은 클릭 한 번으로 해지되며, 이미 지급된 크레딧은 만료될 때까지 그대로 유지됩니다.

컷 작업이 실패하면 어떻게 되나요?

실패한 컷은 절대 청구되지 않습니다 — 지급이 유효한 동안 예약된 크레딧은 자동으로 환불됩니다.

팩과 요금제를 함께 사용할 수 있나요?

네. 팩과 구독 크레딧은 합산되며, 만료일이 가장 빠른 것부터 항상 먼저 사용됩니다.