API-Schlüssel und die REST-API

Schlüssel erstellst du unter Settings → Developers (Inhaber und Admins). Gib dem Schlüssel einen Namen und wähle seinen Zugriff (Access): Read only (wie ein Viewer), Read & write videos (wie ein Member) oder Admin. Der Schlüssel wird nur einmal angezeigt; bewahre ihn sicher auf. Die Schlüsselliste zeigt für jeden Schlüssel den Zugriff, wann er zuletzt verwendet wurde, und Revoke.

Bei jedem Schlüssel siehst du, wann er zuletzt verwendet wurde. Revoke sperrt ihn sofort: Alles, was ihn nutzt, funktioniert ab diesem Moment nicht mehr.

Sende den Schlüssel als Bearer-Token:

curl https://api.pellio.io/v1/videos 
  -H "Authorization: Bearer pk_…"

Hochladen

Das Hochladen hat drei Schritte: Upload anlegen, Datei senden und Pellio dann mitteilen, dass er abgeschlossen ist.

1. Leg den Upload an. Die Antwort enthält das Video und ein Objekt upload mit url, method (PUT) und headers. Die URL ist 6 Stunden gültig.

   curl https://api.pellio.io/v1/videos/uploads 
     -H "Authorization: Bearer pk_…" 
     -H "Content-Type: application/json" 
     -d '{"title":"Onboarding","filename":"onboarding.mp4","size":48213377,"type":"video/mp4"}'

2. Sende die Datei per PUT mit den angegebenen Headern an upload.url. Sie geht direkt in den Speicher.
3. Ruf POST /v1/videos/{id}/complete auf. Erst dann beginnt die Verarbeitung; ohne diesen Schritt startet sie nie. Ein Webhook video.ready sagt dir, wann sie fertig ist.

Dateien müssen Video- oder Audiodateien mit bis zu 20 GB sein. Für große Dateien nutzt du einen fortsetzbaren Upload in Teilen von 16 MB: POST /v1/videos/{id}/multipart, dann /multipart/resume, um zu sehen, welche Teile angekommen sind, und /multipart/complete.

Um stattdessen über einen Link zu importieren, sende POST /v1/videos/import mit der URL der Datei.

Referenz

Alle Endpunkte mit Request- und Response-Schemas und einer interaktiven Konsole findest du in der API-Referenz. Das OpenAPI-Dokument liegt unter https://api.pellio.io/v1/openapi.json.

Rate-Limits

Jeder Schlüssel kann 600 Anfragen pro Minute stellen und 30 Importe pro Minute starten. Eine Antwort 429 bedeutet: langsamer werden und erneut versuchen.