ƒƒffhub.io

Einführung

FFHub macht FFmpeg zur REST-API. Befehl rein, Output-URL raus.

FFHub macht FFmpeg zur REST-API. Du schickst einen ganz normalen ffmpeg-Befehl, wir führen ihn auf Cloud-Workern aus und geben dir die URL der Ausgabedatei zurück. Kein Server-Setup, keine Codec-Installation, kein Ops-Aufwand.

Mit KI integrieren (schnellster Weg)

Der schnellste Weg, FFHub einzubinden, ist die Doku an ein LLM zu geben und es den Client-Code schreiben zu lassen. Kopiere den Prompt unten in ChatGPT, Claude.ai, Gemini oder den KI-Assistenten in deiner IDE (Cursor / Claude Code etc.). Das Template verweist bereits auf unsere llms.txt — das Modell hat damit den nötigen Kontext.

Ich will die FFHub Video-Verarbeitungs-API in mein Projekt integrieren.

Kontext für dich:
- Projekt-Übersicht: https://ffhub.io/llms.txt
- API-Spec: https://api.ffhub.io/openapi.json

Was ich machen will: <Task beschreiben, z.B. "MP4 in MP3 mit 192kbps konvertieren", "Thumbnail bei 5 Sekunden extrahieren", "Video unter 10 MB komprimieren">
Sprache / Runtime: <Node.js / Python / Go / Bash / ...>

Bitte schreib ein vollständiges, lauffähiges Skript, das:
1. Wenn ich eine lokale Datei habe: per POST /v1/uploads/sign eine presigned URL holen, dann die Datei direkt per PUT an diese URL schicken. Die zurückgegebene public_url als FFmpeg-Input verwenden.
2. POST /v1/tasks mit einem `command`-Feld, das die FFmpeg-Argumente und die Input-URL enthält.
3. Die Task per GET /v1/tasks/{id} pollen, bis der Status succeeded oder failed ist, dann von outputs[0].url runterladen.
Lies meinen API-Key aus der Umgebungsvariablen FFHUB_API_KEY.

Im Postman testen

Am schnellsten kommst du über unseren öffentlichen Postman-Workspace zum ersten Request:

OpenAPI-Spec

Die vollständige maschinenlesbare Spec liegt unter api.ffhub.io/openapi.json — sie deckt Task-Management, Account-Infos und den Upload-Signing-Endpoint ab. URL in Postman, Bruno oder Insomnia einfügen, oder per openapi-generator / openapi-typescript einen typisierten Client in beliebiger Sprache generieren.

Alle Endpunkte erwarten einen Bearer Access Token, zu erstellen unter /dashboard/api-keys. GET /v1/tasks/{id} ist aktuell zur Kompatibilität mit älteren ffhub-cli-Releases auch ohne Token aufrufbar — eine künftige Version wird Authentifizierung verlangen.

Was du machen kannst

  • Transkodieren und konvertieren: beliebige Formate, MP4 / WebM / HLS / GIF, Codec-Wechsel
  • Komprimieren und skalieren: Dateigröße verringern, Bitrate oder Auflösung anpassen
  • Bearbeiten: zuschneiden, zusammenfügen, beschneiden, rotieren, Wasserzeichen, Untertitel
  • Extrahieren: Audio, Frames, Thumbnails, Metadaten
  • Alles, was FFmpeg kann — wir führen einfach deinen Befehl aus

Abrechnung

  • 1 Credit = 5 Sekunden Verarbeitungszeit, sekundengenau abgerechnet
  • $1 ≈ 1.000 Credits
  • Gratis-Credits bei der Anmeldung, kein Abo, Credits verfallen nicht

Du zahlst nur für die tatsächliche Verarbeitungszeit, Wartezeit zählt nicht.

Doku-Übersicht

Wähl den Pfad, der zu deinem FFHub-Einsatz passt:

Erste Schritte — neu hier? In dieser Reihenfolge lesen.

  • Schnellstart — dein erster Job in 3 Minuten (curl + Node.js + Python).
  • Dateien hochladen — lokale Dateien in URLs verwandeln, die die API lesen kann (multipart, Base64 oder Remote-URL).

Code-Beispiele — wenn du funktionierenden Code kopieren willst.

  • Beispiele — gängige FFmpeg-Rezepte (Transkodierung, Komprimierung, Trim, Audio-Extraktion, Wasserzeichen).
  • SDK & Code-Beispiele — dieselben Tasks in Node.js / Python / Go.
  • Video-Komprimierung — H.264 vs H.265 vs VP9, CRF-Tuning, Two-Pass.

Integrationen — wenn du keinen HTTP-Code schreiben willst.

  • CLI-Tool — npm install -g ffhub, Jobs vom Terminal aus laufen lassen, lokale Dateien werden automatisch hochgeladen.
  • n8n Community Node — FFHub in n8n Visual Workflows einbinden.
  • Claude Code Skill — FFHub von Claude Code aus als verwalteten FFmpeg-Werkzeugkasten nutzen.

Wenn du erst einen Überblick willst, bevor du in die Endpoints einsteigst, lies den FFmpeg-API-Guide — er erklärt, wozu die API da ist, wie sie sich vom selbst betriebenen FFmpeg unterscheidet und für welche Use Cases sie gebaut ist.

Support

Einführung — FFHub Docs