Authentifizierung

Jede Anfrage braucht einen API-Schlüssel, den du als Bearer-Token mitsendest:

Authorization: Bearer vu_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Wer die API nutzen kann

Die API ist für bezahlte Konten gedacht: Konten, die ein Credit-Paket gekauft oder ein Abo abgeschlossen haben. Kostenlose Konten können keine API-Schlüssel erstellen, und jede Anfrage von einem Konto, das noch nie bezahlt hat, führt zu 403:

{
  "error": {
    "code": "paid_plan_required",
    "message": "The API is available to accounts that have bought credits or subscribed. See https://videoupscaler.co/pricing"
  }
}

Kaufe ein beliebiges Credit-Paket auf der Preisseite, um Zugriff zu erhalten. Der Zugriff bleibt bestehen, auch nachdem du die Credits verbraucht hast; danach musst du nur noch aufladen.

Einen Schlüssel erhalten

Schlüssel erstellst du unter Einstellungen → API-Schlüssel. Du kannst bis zu 20 aktive Schlüssel haben, zum Beispiel einen pro Server oder Umgebung. Die Seite zeigt für jeden Schlüssel den Namen, die ersten und letzten Zeichen sowie den Zeitpunkt der letzten Verwendung.

Der vollständige Schlüssel wird nur einmal angezeigt – direkt beim Erstellen. Wir speichern nur einen Hash davon und können ihn daher nicht erneut anzeigen. Wenn du einen Schlüssel verlierst, lösche ihn und erstelle einen neuen.

Schlüssel sicher aufbewahren

• Ein Schlüssel verbraucht die Credits deines Kontos. Behandle ihn wie ein Passwort.
• Rufe die API von deinem Server aus auf. Verwende einen Schlüssel niemals im Browser, in einer mobilen App oder in einem öffentlichen Repository.
• Lies ihn aus einer Umgebungsvariable, etwa VIDEOUPSCALER_API_KEY.
• Falls ein Schlüssel geleakt wurde, lösche ihn in den Einstellungen. Er funktioniert dann sofort nicht mehr.

Fehler

Ein fehlender, fehlerhafter oder gelöschter Schlüssel führt zu 401:

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Send it as \"Authorization: Bearer vu_live_...\"."
  }
}