Video-Operation

Video framegenau trimmen – ohne ffmpeg im Bundle.

Trimme dein Video so, dass der Clip exakt auf dem gewünschten Frame endet – um die Keyframes kümmert sich Fotovid, damit die Schnittkanten sauber bleiben. Der ffmpeg-Microservice zum direkten Einbinden gibt dir eine gehostete MP4-URL zurück.

curl -X POST https://api.fotovid.co/v1/video/trim \
  -H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.yoursite.com/recording.mp4",
    "params": {
      "start": "00:00:05",
      "end": "00:00:20"
    }
  }'

Video trimmen in Serverless-Functions: schwerer als gedacht

Einen Clip zu schneiden klingt nach einem einzigen ffmpeg-Befehl. Diesen Befehl auf Vercel, Lambda oder Workers auszuführen heißt aber: ein statisches Binary mit über 70 MB ausliefern, gegen Cold Starts und Arbeitsspeicherlimits kämpfen und den Input hineinstreamen sowie den Output irgendwo ablegen, wo er bleiben kann. Framegenaue Schnitte erzwingen ein Re-Encoding, das CPU-Bedarf und Ausführungszeit über das hinaustreibt, was die meisten Serverless-Functions erlauben. Am Ende betreibst du Infrastruktur, die nichts mit deinem Produkt zu tun hat.

  • ffmpeg-Binaries sprengen die Bundle-Größen- und Arbeitsspeicherlimits von Serverless-Functions
  • Framegenaues Trimmen erfordert ein Re-Encoding – langsame, CPU-lastige Arbeit, bei der Serverless-Functions in den Timeout laufen
  • Den Input herunterladen und den fertigen Clip hosten musst du trotzdem noch selbst
  • Nimm diesen Endpoint, wenn du saubere Highlight-Clips, Social-Cuts oder kurze Previews brauchst, ohne eine eigene Media-Pipeline zu betreiben

Request-Parameter

POST /v1/video/trim

FieldTypeDefaultDescription
source_url*string (URL)HTTPS-URL des Quellvideos
params.start*string | number"HH:MM:SS(.mmm)" oder Sekunden (z. B. 5.5)
params.end*string | numberMuss größer als start sein; wird bei EOF abgeschnitten
How it works

Dein erster Call in drei Schritten

  1. 1
    Kostenlosen API-Schlüssel holen

    Registriere dich und erstelle im Dashboard einen API-Schlüssel. Authentifiziert wird über den Header Authorization: Bearer p6_<key_id>:<secret>. Jeder neue Account startet mit kostenlosen Credits, und für 1 $ bekommst du 100 Credits – ein Trim kostet einen Credit pro Call.

  2. 2
    POST /v1/video/trim aufrufen

    Schick einen Request an https://api.fotovid.co/v1/video/trim mit einem JSON-Body aus source_url (der HTTPS-URL deines Eingangsvideos) und einem params-Objekt mit start und end. Beide akzeptieren entweder einen Zeitstempel im Format HH:MM:SS.mmm oder eine reine Sekundenangabe; der Schnitt erfolgt framegenau über das halboffene Intervall [start, end) und wird mit x264 nach MP4 re-encodiert.

  3. 3
    Die zurückgegebene Clip-URL nutzen

    Die Response ist flaches JSON mit id, type, einer von Fotovid gehosteten url für das getrimmte MP4, einem expires_at und der Dauer des Clips. Lade die Datei herunter und leg eine eigene Kopie ab, damit du bestimmst, wo sie liegt – dann kannst du sie ausliefern, anhängen oder an den nächsten Schritt deines Workflows übergeben.

Häufige Fragen

Mit einem API-Call live gehen

Hol dir einen kostenlosen Schlüssel und mach deinen ersten Call in unter fünf Minuten.