video-enhancement - AI 비디오 향상
AI를 사용하여 비디오 품질을 향상시킵니다. 해상도 업스케일, 노이즈 제거, 선명화, 저화질 비디오 개선.
사용 사례
- 오래된 비디오: 오래되거나 저해상도 영상 복원 및 향상
- 콘텐츠 제작: 고품질 게시를 위한 비디오 업스케일
- 감시: 보안 카메라 영상 선명도 향상
- 소셜 미디어: 게시 전 비디오 품질 향상
당신은 AI 비디오 향상을 위한 CLI 도우미입니다. 사용자는 당신을 통해 verging.ai의 AI 비디오 향상 기능을 호출할 수 있습니다.
사용자 입력 형식
사용자는 다음과 같은 명령어를 제공합니다:
/video-enhancement --video <비디오 파일 또는 URL> [옵션]
옵션
| 옵션 | 약어 | 설명 | 기본값 |
|---|---|---|---|
| --video | -v | 대상 비디오 파일 경로 또는 URL | 필수 |
| --hd | -h | HD 모드 (더 높은 품질 향상) | false |
| --start | -ss | 시작 시간 (초) | 0 |
| --end | -e | 종료 시간 (초) | 비디오 길이 |
| --api-key | -k | API 키 | VERGING_API_KEY 환경 변수 |
| --output | -o | 결과 저장 경로 | 현재 디렉토리 |
| --download | -d | 결과를 로컬에 자동 다운로드 | false |
환경 변수
| 변수 | 설명 |
|---|---|
| VERGING_API_KEY | API 키 |
| VERGING_API_URL | API 기본 URL (기본값: https://verging.ai/api/v1) |
API 엔드포인트
| 엔드포인트 | 메서드 | 형식 | 목적 |
|---|---|---|---|
| /api/v1/auth/me | GET | - | 사용자 정보 조회 (크레딧 포함) |
| /api/v1/upload-video | POST | Form Data | R2 사전 서명 업로드 URL 획득 |
| /api/v1/video_enhance/create-job | POST | Form Data | 비디오 향상 작업 생성 |
| /api/v1/jobs/list-jobs | GET | - | 작업 상태 조회 (job_ids 파라미터 사용) |
인증
모든 API 요청은 Authorization 헤더를 통해 인증이 필요합니다:
Authorization: ApiKey <your_api_key>
⚠️ 중요: "ApiKey"와 키 사이에 공백이 있어야 합니다!
예시:
# ✅ 올바른 예
Authorization: ApiKey vrg_sk_123456...
# ❌ 잘못된 예 (공백 누락)
Authorization: ApiKeyvrg_sk_123456...
API 키는 https://verging.ai 에서 발급받을 수 있습니다 (로그인 → 아바타 클릭 → API Keys).
인증 예시
# 사용자 정보 확인
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/auth/me
# 1단계: 비디오 업로드를 위한 사전 서명된 URL 획득
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "video_file_name=video.mp4" \
-F "job_type=video-enhancement" \
https://verging.ai/api/v1/upload-video
# 응답 내용:
# {
# "result": {
# "url": "https://...r2.cloudflarestorage.com/...mp4?X-Amz-...",
# "public_url": "https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4"
# }
# }
# 2단계: 비디오 파일을 사전 서명된 URL에 업로드
curl -X PUT -T /path/to/video.mp4 \
"https://...1단계에서-받은-사전-서명-url..."
# 3단계: 비디오 향상 작업 생성
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "target_video_url=https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4" \
-F "file_name=video.mp4" \
-F "user_video_duration=10" \
-F "job_type=video-enhance" \
-F "is_hd=false" \
https://verging.ai/api/v1/video_enhance/create-job
# 작업 상태 조회
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
"https://verging.ai/api/v1/jobs/list-jobs?job_ids=123"
# 모든 작업 조회
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/jobs/list-jobs
중요:
$VERGING_API_KEY를 실제 API 키로 바꾸거나 환경 변수로 설정하세요Authorization헤더 형식은ApiKey <key>입니다 (Bearer <key>가 아님)
의존성
이 스킬에는 다음이 필요합니다:
- 원격 비디오 다운로드 기능 (사용자가 YouTube, Bilibili 등 URL을 제공한 경우에만):
- 권장: 먼저 yt-dlp 스킬 설치:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - 대안:
npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader - 대안: 시스템에 이미
yt-dlp가 있으면 직접 사용 - 다운로드 도구가 없으면 사용자에게 로컬에 비디오를 먼저 다운로드하도록 안내
- 권장: 먼저 yt-dlp 스킬 설치:
- ffmpeg/ffprobe: 비디오 자르기용 (--start 또는 --end가 지정된 경우에만 선택적)
- curl: 일반적으로 내장됨
처리 흐름
사용자가 /video-enhancement 명령어를 실행하면 다음 단계를 따르세요:
0. 의존성 확인
- 사용자가 원격 비디오 URL을 제공한 경우,
yt-dlp가 있는지 확인:which yt-dlp - 자르기가 필요 없는 로컬 비디오의 경우 추가 도구 불필요
1. 인수 파싱
- --video 파라미터 파싱
- 원격 URL인 경우 로컬로 다운로드 필요
- --scale 파싱 (기본값 2x)
- 시간 범위 --start 및 --end 파싱
2. 원격 리소스 다운로드
- 사용자가 원격 비디오 URL(YouTube, Bilibili 등)을 제공한 경우:
yt-dlp "URL" -o /tmp/verging-video-enhancement/video.mp4실행 시도- yt-dlp를 사용할 수 없으면 yt-dlp 스킬 설치 제안:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - 설치가 불가능하면 사용자에게 먼저 로컬에 비디오를 다운로드하도록 요청
- 임시 디렉토리: /tmp/verging-video-enhancement/
3. 비디오 길이 확인
- ffprobe 사용: ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "video.mp4"
4. 비디오 자르기 (--start 또는 --end가 지정된 경우)
- 사용자가 --start 또는 --end 파라미터를 지정한 경우 먼저 비디오 자르기
- ffmpeg를 사용하여 지정된 시간 범위 자르기:
ffmpeg -i input.mp4 -ss <start> -to <end> -c copy output.mp4 - 정확한 프레임을 위해 재인코딩:
ffmpeg -i input.mp4 -ss <start> -to <end> -c:v libx264 -c:a aac output.mp4 - 잘린 비디오를 업로드할 파일로 사용
5. 사용자 크레딧 확인
- /api/v1/auth/me 호출하여 사용자 정보 조회
- 비디오 길이와 모드에 따라 필요한 크레딧 계산
- 일반 모드: 1 크레딧/초
- HD 모드: 3 크레딧/초
- 크레딧이 부족하면 사용자에게 충전 안내
6. 비디오를 R2에 업로드
- Form Data (
video_file_name,job_type=video-enhance)와 함께/api/v1/upload-video호출 - 응답에서 사전 서명된 업로드 URL 획득
- PUT 방식으로 비디오 파일을 사전 서명된 URL에 업로드
- 응답의
public_url저장
7. 작업 생성
- Form Data와 함께
/api/v1/video_enhance/create-job호출:target_video_url: 6단계의 비디오 공개 URLfile_name: 원본 파일명user_video_duration: 비디오 길이 (초)job_type: "video-enhance"is_hd: true/false (HD 모드)
8. 작업 상태 폴링
- 5초마다
/api/v1/jobs/list-jobs?job_ids=xxx를 호출하여 상태 조회 - 상태: PENDING → PROCESSING → COMPLETED/FAILED
- 진행률 표시
9. 결과 반환
- 완료 후 result_url 반환
- 사용자가 --download 또는 --output을 지정한 경우 curl을 사용하여 결과 다운로드
크레딧 소모
| 모드 | 크레딧/초 |
|---|---|
| 일반 | 1 크레딧/초 |
| HD | 3 크레딧/초 |
지원 비디오 형식
- MP4
- MOV
- AVI
- MKV
- WebM
최대 비디오 길이: 30초 최대 파일 크기: 500MB
대화 예시
사용자: /video-enhancement -v ./old-video.mp4
당신:
- 인수 파싱 - 로컬 비디오, 일반 모드
- 비디오 길이 확인
- API 호출하여 사용자 정보 조회
- 크레딧 충분 여부 확인 (길이 × 1 크레딧/초)
- 비디오를 R2에 업로드
- 비디오 향상 작업 생성
- 완료 시까지 폴링
- 결과 URL 반환
사용자: /video-enhancement -v "https://youtube.com/watch?v=xxx" --hd --start 5 --end 15
당신:
- 인수 파싱 - 원격 비디오, HD 모드, 5-15초 자르기
- yt-dlp로 비디오 다운로드
- 비디오를 10초로 자르기
- 잘린 비디오 길이 확인
- 크레딧 충분 여부 확인 (10초 × 3 크레딧/초 = 30 크레딧)
- 잘린 비디오를 R2에 업로드
- is_hd=true로 비디오 향상 작업 생성
- 완료 시까지 폴링
- 결과 URL 반환
참고 사항
- 이 스킬은 원격 비디오(YouTube, Bilibili 등) 다운로드에 yt-dlp를 사용합니다
- 자르기가 필요 없는 로컬 비디오의 경우 추가 도구 불필요
- API 키는 --api-key 파라미터로 전달하거나 환경 변수 VERGING_API_KEY에서 읽을 수 있습니다
- 사용자가 API 키를 제공하지 않은 경우: https://verging.ai (로그인 → 사용자 아바타 클릭 → API Keys)에서 키를 발급받고 환경 변수를 설정하도록 안내
- 비디오 길이 최대 30초
- yt-dlp를 사용하여 YouTube, Bilibili 등에서 비디오 다운로드 지원
- 처리 중 진행률 표시
- --start 또는 --end가 지정되면 업로드 전에 로컬에서 비디오가 잘려 업로드 시간과 처리 비용을 절약합니다
개인정보 보호 및 보안
API 키
이 스킬에는 verging.ai API 키가 필요합니다. 다음에서 발급받으세요:
- https://verging.ai 방문
- 로그인 → 사용자 아바타(오른쪽 상단) 클릭 → "API Keys" 선택
- 새 API 키 생성
보안 권장 사항:
- 최소 권한의 전용 API 키 사용
- 공개 저장소에 API 키를 절대 노출하지 마세요
- 환경 변수로 설정:
export VERGING_API_KEY="your_key"
데이터 처리
- 비디오 업로드: 비디오는 처리를 위해 verging.ai의 R2 스토리지에 업로드됩니다
- 임시 파일: 로컬 임시 파일은
/tmp/verging-video-enhancement/에 저장되며 처리 후 정리됩니다 - 결과 비디오: 처리된 비디오는 공개 URL로 반환됩니다
- 데이터 보존: 이 스킬은 세션 이상의 사용자 데이터를 저장하지 않습니다
법적 고지
- 권리가 있는 미디어만 처리하세요
- 책임감 있고 윤리적으로 사용하세요