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.

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 der Video-Kodierung 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]
  ]
]);

Kodierungsprozess

Nach dem Upload der Videodatei wird das Video kodiert. Je nach Dateigröße und Komplexität kann das eine Weile dauern.

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