OpenClip: 비디오 편집
edit_video는 비디오 파일에 대해 한 번 호출에 하나의 작업(자르기, 트림, 회전, 크기 조정, 압축, 음소거)을 수행합니다. 무료이며, OpenClip 계정이 필요하지만 구독이나 크레딧은 필요하지 않습니다.
작업을 결합하려면 호출을 체이닝하십시오: 한 호출의 출력을 다음 호출의 입력으로 전달하십시오.
설정 (한 번만)
OpenClip은 https://openclip.app/mcp에 있는 원격 MCP 서버입니다. OAuth 프롬프트가 나타나면 OpenClip 계정으로 로그인하십시오. 복사할 API 키는 없습니다.
- Claude Code:
claude mcp add --transport http openclip https://openclip.app/mcp, 그런 다음/mcp로 인증. - Claude Desktop / 웹: 설정, 커넥터, "사용자 정의 커넥터 추가", URL을 붙여넣고 로그인.
- Cursor (
.cursor/mcp.json):{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } } - 헤더 전용 클라이언트:
openclip.app/settings/connect에서 MCP 토큰을 발급받고Authorization: Bearer <token>으로https://openclip.app/mcp/key에 연결하십시오.
확인: get_account를 호출하십시오.
파일 가져오기
create_upload(filename, content_type)은id와upload_url을 반환합니다.- 원시 바이트를
upload_url에 PUT하십시오. - 반환된
id를video인수로 전달하십시오.
complete_upload를 호출하지 마십시오. 그 호출은 유료 클리핑 파이프라인을 시작합니다. 무료 도구는 업로드된 파일을 직접 읽습니다. list_videos에 이미 있는 비디오도 입력으로 사용할 수 있습니다.
작업
모든 호출은 edit_video(video, operation, ...params)입니다.
- crop -
aspect("1:1","9:16","16:9","4:5") 또는 명시적x,y,width,height. TikTok, Reels, Shorts용으로 가로 영상을 리프레임하려면aspect: "9:16"을 사용하십시오. - trim -
start_ms와end_ms, 둘 다 필수. 시간은 밀리초입니다. - rotate -
degrees(90,180,270) 및/또는flip(none,horizontal,vertical). - resize - 픽셀 단위의
width와height. - compress -
target_mb(파일 크기 목표) 또는crf(18~32, 낮을수록 품질이 좋고 파일이 큼). 사용자가 크기 제한을 언급할 때는target_mb를 사용하십시오. - mute - 매개변수 없음, 오디오 트랙을 제거합니다.
폴링
edit_video는 status: "queued"와 함께 tool_job 해시 ID를 반환합니다. 5~10초마다 get_tool_job_status(tool_job)을 폴링하십시오:
queued/processing- 아직 작업 중, 계속 폴링.completed- 영구 CDNoutputsURL과result_meta를 반환.failed-error를 반환.
호출이 동기적으로 완료되었다고 가정하지 마십시오.
규칙
- 한 번 호출에 하나의 작업. 트림 후 리프레임하려면 먼저 트림을 실행하고, 그 출력을 자르기 호출에 전달하십시오.
- 시간은 모든 곳에서 밀리초이며, 초가 아닙니다.
- 출력 URL은 영구 CDN 링크이며, 서명되거나 만료되지 않습니다.
- 무료 사용은 일일 속도 제한과 파일 크기 제한이 있습니다. 오류 텍스트는 제한을 해제하는 방법을 설명합니다.
예시 프롬프트와 작업
- "이것을 처음 30초로 자르기" -
create_upload, PUT 바이트,edit_video(video, operation="trim", start_ms=0, end_ms=30000), 폴링. - "TikTok용으로 세로로 만들기" -
edit_video(video, operation="crop", aspect="9:16"), 폴링. - "이 파일이 400MB인데, 50 미만으로 줄이기" -
edit_video(video, operation="compress", target_mb=50), 폴링. - "오디오 제거" -
edit_video(video, operation="mute"), 폴링. - "중간 1분으로 트림하고 정사각형으로 만들기" - 트림, 폴링, 그런 다음 출력을
aspect="1:1"로 자르기, 다시 폴링.
관련
포맷 변환(mp4, gif, mp3)은 convert_media이며, openclip-convert 스킬을 참조하십시오. 긴 비디오를 순위별 짧은 클립으로 변환하는 것은 유료 파이프라인이며, openclip-clipping을 참조하십시오.