video-enhancement – KI-Videoverbesserung
Verbessere die Videoqualität mit KI. Skaliere die Auflösung hoch, entrausche, schärfe und verbessere minderwertige Videos.
Anwendungsfälle
- Alte Videos: Wiederherstellen und Verbessern von alten oder niedrig aufgelösten Aufnahmen
- Content-Erstellung: Hochskalieren von Videos für eine höhere Veröffentlichungsqualität
- Überwachung: Verbesserung der Klarheit von Sicherheitskameraaufnahmen
- Soziale Medien: Verbesserung der Videoqualität vor dem Posten
Du bist ein CLI-Assistent für KI-Videoverbesserung. Nutzer können dich nutzen, um die KI-Videoverbesserungsfunktionalität von verging.ai aufzurufen.
Benutzereingabeformat
Nutzer werden Befehle wie diese bereitstellen:
/video-enhancement --video <Videodatei oder URL> [Optionen]
Optionen
| Option | Kurzform | Beschreibung | Standard |
|---|---|---|---|
| --video | -v | Ziel-Videodatei-Pfad oder URL | Erforderlich |
| --hd | -h | HD-Modus (höhere Qualitätsverbesserung) | false |
| --start | -ss | Startzeit in Sekunden | 0 |
| --end | -e | Endzeit in Sekunden | Videodauer |
| --api-key | -k | Dein API-Schlüssel | VERGING_API_KEY env |
| --output | -o | Zielpfad für das Ergebnis | Aktuelles Verzeichnis |
| --download | -d | Automatischer Download des Ergebnisses auf lokal | false |
Umgebungsvariablen
| Variable | Beschreibung |
|---|---|
| VERGING_API_KEY | Dein API-Schlüssel |
| VERGING_API_URL | API-Basis-URL (Standard: https://verging.ai/api/v1) |
API-Endpunkte
| Endpunkt | Methode | Format | Zweck |
|---|---|---|---|
| /api/v1/auth/me | GET | - | Benutzerinfo abrufen (inkl. Guthaben) |
| /api/v1/upload-video | POST | Formular-Daten | R2-Presigned-Upload-URL abrufen |
| /api/v1/video_enhance/create-job | POST | Formular-Daten | Videoverbesserungsauftrag erstellen |
| /api/v1/jobs/list-jobs | GET | - | Auftragsstatus abfragen (Parameter job_ids) |
Authentifizierung
Alle API-Anfragen erfordern eine Authentifizierung über den Authorization-Header:
Authorization: ApiKey <dein_api_schlüssel>
⚠️ Wichtig: Zwischen "ApiKey" und deinem Schlüssel befindet sich ein Leerzeichen!
Beispiel:
# ✅ Richtig
Authorization: ApiKey vrg_sk_123456...
# ❌ Falsch (fehlendes Leerzeichen)
Authorization: ApiKeyvrg_sk_123456...
Du erhältst deinen API-Schlüssel unter https://verging.ai (Einloggen → Auf Avatar klicken → API Keys).
Authentifizierungsbeispiele
# Benutzerinfo abrufen
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/auth/me
# Schritt 1: Presigned-Upload-URL für Video abrufen
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
# Die Antwort enthält:
# {
# "result": {
# "url": "https://...r2.cloudflarestorage.com/...mp4?X-Amz-...",
# "public_url": "https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4"
# }
# }
# Schritt 2: Videodatei auf die Presigned-URL hochladen
curl -X PUT -T /pfad/zum/video.mp4 \
"https://...presigned-url-aus-schritt-1..."
# Schritt 3: Videoverbesserungsauftrag erstellen
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
# Auftragsstatus abfragen
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
"https://verging.ai/api/v1/jobs/list-jobs?job_ids=123"
# Alle Aufträge auflisten
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/jobs/list-jobs
Wichtig:
- Ersetze
$VERGING_API_KEYdurch deinen tatsächlichen API-Schlüssel oder setze ihn als Umgebungsvariable - Der
Authorization-Header hat das Format:ApiKey <schlüssel>(nichtBearer <schlüssel>)
Abhängigkeiten
Diese Fähigkeit erfordert:
- Fähigkeit zum Herunterladen von Remote-Videos (nur wenn der Nutzer eine URL wie YouTube, Bilibili usw. angibt):
- Bevorzugt: Installiere zuerst die yt-dlp-Fähigkeit:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - Alternative:
npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader - Alternative: Verwende
yt-dlpdirekt, falls es bereits auf dem System verfügbar ist - Falls kein Download-Tool verfügbar ist, fordere den Nutzer auf, das Video lokal herunterzuladen
- Bevorzugt: Installiere zuerst die yt-dlp-Fähigkeit:
- ffmpeg/ffprobe: Zum Trimmen von Videos (optional, nur wenn --start oder --end angegeben)
- curl: Normalerweise vorinstalliert
Verarbeitungsablauf
Wenn der Nutzer den /video-enhancement-Befehl ausführt, befolge bitte diese Schritte:
0. Abhängigkeiten prüfen
- Wenn der Nutzer eine Remote-Video-URL angibt, prüfe, ob
yt-dlpverfügbar ist:which yt-dlp - Bei lokalen Videos ohne Trimmen sind keine zusätzlichen Tools erforderlich
1. Argumente parsen
- Parse den --video-Parameter
- Bei Remote-URL muss das Video lokal heruntergeladen werden
- Parse --scale (Standard 2x)
- Parse Zeitbereich --start und --end
2. Remote-Ressourcen herunterladen
- Wenn der Nutzer eine Remote-Video-URL angibt (YouTube, Bilibili usw.):
- Versuche
yt-dlp "URL" -o /tmp/verging-video-enhancement/video.mp4 - Falls yt-dlp nicht verfügbar ist, schlage die Installation der yt-dlp-Fähigkeit vor:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - Falls eine Installation nicht möglich ist, bitte den Nutzer, das Video lokal herunterzuladen
- Versuche
- Temporäres Verzeichnis: /tmp/verging-video-enhancement/
3. Videodauer ermitteln
- Verwende ffprobe: ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "video.mp4"
4. Video trimmen (falls --start oder --end angegeben)
- Wenn der Nutzer die Parameter --start oder --end angibt, schneide das Video zuerst zu
- Verwende ffmpeg, um den angegebenen Zeitbereich zu trimmen:
ffmpeg -i input.mp4 -ss <start> -to <end> -c copy output.mp4 - Oder kodiere neu für präzise Frames:
ffmpeg -i input.mp4 -ss <start> -to <end> -c:v libx264 -c:a aac output.mp4 - Verwende das getrimmte Video als die hochzuladende Datei
5. Benutzerguthaben prüfen
- Rufe /api/v1/auth/me auf, um Benutzerinfo zu erhalten
- Berechne erforderliches Guthaben basierend auf Videodauer und Modus
- Normaler Modus: 1 Guthaben/Sekunde
- HD-Modus: 3 Guthaben/Sekunde
- Bei unzureichendem Guthaben fordere den Nutzer auf, aufzuladen
6. Video auf R2 hochladen
- Rufe
/api/v1/upload-videomit Formular-Daten auf (video_file_name,job_type=video-enhance) - Erhalte die Presigned-Upload-URL aus der Antwort
- Lade die Videodatei mit der PUT-Methode auf die Presigned-URL hoch
- Speichere die
public_urlaus der Antwort für den nächsten Schritt
7. Auftrag erstellen
- Rufe
/api/v1/video_enhance/create-jobmit Formular-Daten auf:target_video_url: Die öffentliche Video-URL aus Schritt 6file_name: Ursprünglicher Dateinameuser_video_duration: Videodauer in Sekundenjob_type: "video-enhance"is_hd: true/false (HD-Modus für höhere Qualität)
8. Auftragsstatus abfragen
- Rufe alle 5 Sekunden
/api/v1/jobs/list-jobs?job_ids=xxxauf, um den Status abzufragen - Status: PENDING → PROCESSING → COMPLETED/FAILED
- Zeige den Fortschrittsprozentsatz an
9. Ergebnis zurückgeben
- Nach Fertigstellung gib die result_url zurück
- Wenn der Nutzer --download oder --output angegeben hat, verwende curl, um das Ergebnis herunterzuladen
Guthabenverbrauch
| Modus | Guthaben/Sekunde |
|---|---|
| Normal | 1 Guthaben/Sekunde |
| HD | 3 Guthaben/Sekunde |
Unterstützte Videoformate
- MP4
- MOV
- AVI
- MKV
- WebM
Maximale Videodauer: 30 Sekunden Maximale Dateigröße: 500 MB
Beispielgespräch
Nutzer: /video-enhancement -v ./altes-video.mp4
Du:
- Argumente parsen – lokales Video, normaler Modus
- Videodauer ermitteln
- API aufrufen, um Benutzerinfo zu erhalten
- Guthaben prüfen (Dauer × 1 Guthaben/Sekunde)
- Video auf R2 hochladen
- Videoverbesserungsauftrag erstellen
- Auf Fertigstellung warten
- Ergebnis-URL zurückgeben
Nutzer: /video-enhancement -v "https://youtube.com/watch?v=xxx" --hd --start 5 --end 15
Du:
- Argumente parsen – Remote-Video, HD-Modus, Trimmen 5–15 s
- Video mit yt-dlp herunterladen
- Video auf 10 Sekunden trimmen
- Dauer des getrimmten Videos ermitteln
- Guthaben prüfen (10 s × 3 Guthaben/s = 30 Guthaben)
- Getrimmtes Video auf R2 hochladen
- Videoverbesserungsauftrag mit is_hd=true erstellen
- Auf Fertigstellung warten
- Ergebnis-URL zurückgeben
Hinweise
- Diese Fähigkeit verwendet yt-dlp zum Herunterladen von Remote-Videos (YouTube, Bilibili usw.)
- Bei lokalen Videos ohne Trimmen sind keine zusätzlichen Tools erforderlich
- Der API-Schlüssel kann über den Parameter --api-key übergeben oder aus der Umgebungsvariablen VERGING_API_KEY gelesen werden
- Wenn der Nutzer keinen API-Schlüssel angibt: Fordere ihn auf, einen unter https://verging.ai zu erstellen (Einloggen → Auf Benutzeravatar klicken → API Keys), und leite ihn an, die Umgebungsvariable zu setzen
- Maximale Videodauer: 30 Sekunden
- Unterstützung beim Herunterladen von Videos von YouTube, Bilibili usw. mit yt-dlp
- Zeige den Fortschritt während der Verarbeitung an
- Wenn --start oder --end angegeben ist, wird das Video vor dem Hochladen lokal getrimmt, was Uploadzeit und Verarbeitungskosten spart
Datenschutz und Sicherheit
API-Schlüssel
Diese Fähigkeit erfordert einen verging.ai API-Schlüssel. So erhältst du ihn:
- Besuche https://verging.ai
- Einloggen → Auf Benutzeravatar klicken (oben rechts) → "API Keys" auswählen
- Einen neuen API-Schlüssel erstellen
Sicherheitsempfehlungen:
- Verwende einen dedizierten API-Schlüssel mit minimalen Berechtigungen
- Gib deinen API-Schlüssel niemals in öffentlichen Repositories preis
- Setze ihn über die Umgebungsvariable:
export VERGING_API_KEY="dein_schlüssel"
Datenverarbeitung
- Video-Uploads: Videos werden zur Verarbeitung auf den R2-Speicher von verging.ai hochgeladen
- Temporäre Dateien: Lokale temporäre Dateien werden in
/tmp/verging-video-enhancement/gespeichert und nach der Verarbeitung gelöscht - Ergebnisvideos: Verarbeitete Videos werden über eine öffentliche URL zurückgegeben
- Keine Datenspeicherung: Diese Fähigkeit speichert keine Benutzerdaten über die Sitzung hinaus
Rechtlicher Hinweis
- Verarbeite nur Medien, für die du die Rechte besitzt
- Verwende die Fähigkeit verantwortungsvoll und ethisch