Videos hochladen

Videos lädst du hoch, indem du eine PUT-Anfrage an den Endpoint /videos/upload sendest, um ein neues Video-Objekt anzulegen. In der Antwort erhältst du eine signierte S3-URL, über die du die Videodatei hochladen kannst.

Zum Erstellen eines Videos brauchst du die Berechtigung videos.create. Wenn du visibility auf public setzt, brauchst du außerdem videos.publish. Ohne publish wird das Video als private angelegt. Siehe Authentifizierung.

Video-Objekt anlegen

CURL


curl -X PUT https://app.ignitevideo.cloud/api/videos/upload \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "Your video title", "visibility": "private" | "public"}'

JavaScript / Node.js


const data = {
  "title": "Your video title",
  "visibility": "private" | "public" // optional
  "categories": ["category-id", "..."] // optional
  "tags": ["tag-id", "..."] // optional
}
const response = await fetch(`https://app.ignitevideo.cloud/api/videos/upload`, {
method: 'PUT',
body: JSON.stringify(data),
headers: {
  'Authorization': 'Bearer YOUR_TOKEN',
  'Content-Type': 'application/json'
}
});

PHP


$client = new GuzzleHttp\Client();
$data = [
  "title" => "Your video title",
  "visibility" => "private" | "public" // optional
  "categories" => ["category-id", "..."] // optional
  "tags" => ["tag-id", "..."] // optional
];
 
$response = $client->request('PUT', 'https://app.ignitevideo.cloud/api/videos/upload', [
'body' => json_encode($data),
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN',
  'Content-Type' => 'application/json'
]
]);

Hast du ein Video mit gesprochenem Inhalt und möchtest du die KI-Auto-Transkription direkt nach dem Video-Encoding starten, kannst du dazu zwei zusätzliche Parameter beim PUT-Request zum Anlegen des neuen Videos setzen:


{ 
  ...,
  "language": string, // "de-DE" | "..."  locale of the spoken language
  "autoTranscribe": true
}

Antwort


{
  "videoId": "[VIDEO_ID]",
  "title": "Your video title",
  "signedUrl": "[SIGNED_URL]",
}

Videodatei hochladen

Lade deine Videodatei per PUT-Anfrage zu der signierten URL aus dem vorherigen Schritt hoch. Du musst den MIME-Typ der Datei als Content-Type-Header übergeben. Den MIME-Typ kannst du aus deiner lokalen Videodatei über das Datei-Input-Element auslesen.

Bei großen Dateien (über 100 MB) empfehlen wir stattdessen den Multipart Upload – zuverlässiger und für Dateien bis 60 GB. Du kannst auch die Uppy-Bibliothek nutzen – einfacher mit automatischem Chunking und Fortschrittsanzeige.

CURL


curl -X PUT [SIGNED_URL] \
  -H "Content-Type: [MIME_TYPE]" \
  --data-binary "@[PATH_TO_VIDEO_FILE]"

JavaScript / Node.js


const response = await fetch([SIGNED_URL], {
  method: 'PUT',
  body: [VIDEO_FILE],
  headers: {
    'Content-Type': [MIME_TYPE]
  }
});

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('PUT', [SIGNED_URL], [
  'body' => [VIDEO_FILE],
  'headers' => [
    'Content-Type' => [MIME_TYPE]
  ]
]);

Encoding-Prozess

Nach dem Upload der Videodatei startet das Encoding. Je nach Dateigröße und Encoding-Komplexität kann das eine Weile dauern.

Den Encoding-Status prüfst du über den Endpoint /videos/[VIDEO_ID] wie im Abschnitt Video abrufen beschrieben.