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 <あなたのAPIキー>
⚠️ 重要: 「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://...presigned-url-from-step-1..."
# ステップ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 <キー>です(Bearer <キー>ではありません)
依存関係
このスキルには以下が必要です:
- リモート動画ダウンロード機能(ユーザーが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にアップロード
/api/v1/upload-videoをForm Data(video_file_name、job_type=video-enhance)で呼び出し- レスポンスから事前署名付きアップロードURLを取得
- PUTメソッドで動画ファイルを事前署名付きURLにアップロード
- レスポンスの
public_urlを次のステップのために保存
7. ジョブの作成
/api/v1/video_enhance/create-jobをForm Dataで呼び出し:target_video_url: ステップ6の動画公開URLfile_name: 元のファイル名user_video_duration: 動画の長さ(秒)job_type: "video-enhance"is_hd: true/false(高品質モードの場合)
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を返却
注意事項
- このスキルはリモート動画のダウンロードにyt-dlpを使用します(YouTube、Bilibiliなど)
- トリミングなしのローカル動画の場合、追加ツールは不要
- 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で返却されます
- データ保持なし: このスキルはセッションを超えてユーザーデータを保存しません
法的注意事項
- 権利のあるメディアのみを処理してください
- 責任を持って倫理的に使用してください