video-enhancement

video-enhancement - AI 動画高画質化

verging.ai を使用し、AI で動画をアップスケールして画質を向上させます。

コマンド形式

/video-enhancement --video <video file or URL> [options]

オプション

オプション	短縮形	説明	デフォルト
--video	-v	動画ファイルのパスまたは URL（YouTube/Bilibili）	必須
--start	-s	開始時間（秒）	0
--end	-e	終了時間（秒）	動画の最後（最大 30 秒）
--hd		HD アップスケーリング（5 クレジット/秒）	false（3 クレジット/秒）
--api-key	-k	API キー	$VERGING_API_KEY
--output	-o	結果の保存先	現在のディレクトリ
--download	-d	結果を自動ダウンロード	false

認証

推奨： Authorization: ApiKey <your_key>

# ✅ Recommended (canonical form)
curl -H "Authorization: ApiKey vrg_sk_your_key_here" https://verging.ai/api/v1/auth/me

# ✅ Also works (Bearer with API key is supported)
curl -H "Authorization: Bearer vrg_sk_your_key_here" https://verging.ai/api/v1/auth/me

API キーはこちらから取得してください：https://verging.ai → ログイン → アバター → API Keys

API リファレンス（正確な形式）

1. クレジットを確認

curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  https://verging.ai/api/v1/auth/me

レスポンス：{"email":"...","name":"...","credits":100}

2. アップロード URL を取得（フォームデータ — JSON ではありません）

# ⚠️ MUST use -F (multipart form-data)
curl -X POST https://verging.ai/api/v1/upload-video \
  -H "Authorization: ApiKey $VERGING_API_KEY" \
  -F "video_file_name=video.mp4" \
  -F "job_type=video-enhance"

レスポンス：

{
  "code": 100000,
  "result": {
    "url": "https://...presigned-url...",
    "public_url": "https://img.panpan8.com/video-enhance/..."
  }
}

3. 動画を R2 にアップロード

curl -X PUT -T /tmp/verging-video-enhancement/trimmed.mp4 \
  -H "Content-Type: video/mp4" \
  "<presigned_url_from_step_2>"

4. 高画質化ジョブを作成（フォームデータ）

# ⚠️ Uses -F (form-data), NOT JSON
curl -X POST https://verging.ai/api/v1/video_enhance/create-job \
  -H "Authorization: ApiKey $VERGING_API_KEY" \
  -F "target_video_url=<public_url_from_step_2>" \
  -F "file_name=video.mp4" \
  -F "user_video_duration=30" \
  -F "job_type=video-enhance" \
  -F "is_hd=false"

レスポンス：{"code":10000,"result":{"job_id":"123"},"message":{"en":"Request Success","zh":"提交任务成功"}}

5. ジョブのステータスをポーリング

curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  "https://verging.ai/api/v1/jobs/list-jobs?job_ids=<job_id>"

レスポンス：[{"id":123,"job_type":"video-enhance","status":"COMPLETED","progress":100,"result_url":"https://...","created_at":"...","updated_at":"..."}]

ステータス値：PENDING → PROCESSING → COMPLETED（または FAILED）

実行フロー（必ず順守してください）

1. 引数を解析 → 動画のパス／URLとオプションを抽出します
2. リモート動画をダウンロード（URL の場合）：yt-dlp "URL" -o /tmp/verging-video-enhancement/input.mp4
3. 再生時間を取得 → ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 video.mp4
4. 必要に応じてトリミング（--start/--end または再生時間が 30 秒を超える場合）：

   ffmpeg -i input.mp4 -ss <start> -to <end> -c:v libx264 -c:a aac /tmp/verging-video-enhancement/trimmed.mp4
   

5. クレジットを確認 → GET /api/v1/auth/me（再生時間 × 3（通常）または ×5（HD）が必要です）
6. 動画をアップロード → POST /upload-video（フォームデータ）→ 署名付き URL に PUT
7. ジョブを作成 → POST /video_enhance/create-job（フォームデータ）
8. ステータスをポーリング → GET /jobs/list-jobs?job_ids=X を 5 秒ごとに、COMPLETED になるまで実行します
9. 結果を返す／ダウンロード → result_url を表示し、必要に応じて curl でダウンロードします

重要な注意事項

• Authorization: ApiKey <key> を使用してください（推奨） — Bearer <key> も使用できます
• /upload-video はフォームデータ（-F）を使用します — JSON ではありません
• /video_enhance/create-job はフォームデータ（-F）を使用します — JSON ではなく、ファイルのアップロードも不要です
• 動画の最大再生時間：30 秒 — それより長い動画は先にトリミングしてください
• 一時ディレクトリ： /tmp/verging-video-enhancement/
• yt-dlp が利用できない場合は、ユーザーに動画を手動でダウンロードするよう依頼してください

クレジット消費量

モード	コスト
通常	3 クレジット/秒
HD	5 クレジット/秒

プライバシーとセキュリティ

• 環境変数でキーを設定します：export VERGING_API_KEY="your_key"
• API キーを公開リポジトリで決して公開しないでください
• 権利を持つメディアのみを処理してください
• 一時ファイルは使用後に削除されます