Caricamento dei video

Il caricamento dei video avviene inviando una richiesta PUT all’endpoint /videos/upload per creare un nuovo oggetto video. Riceverai una risposta con un URL S3 firmato su cui caricare il file video.

Crea l’oggetto video

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'
]
]);

Se hai un video con contenuto parlato e vuoi avviare la trascrizione automatica AI subito dopo la codifica del video, puoi farlo impostando due parametri aggiuntivi nella richiesta PUT per creare il nuovo video:


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

Risposta


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

Carica il file video

Carica il file video con una richiesta PUT all’URL firmato restituito nel passaggio precedente. Devi indicare il tipo MIME del file nell’header Content-Type. Puoi ottenere il tipo MIME dal file video locale tramite l’elemento input file.

Per file di grandi dimensioni (oltre 100 MB), ti consigliamo di usare invece il caricamento multipart, che offre maggiore affidabilità e supporta file fino a 60 GB. Puoi anche usare la libreria Uppy per un’implementazione più semplice con chunk automatici e tracciamento dell’avanzamento.

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]
  ]
]);

Processo di codifica

Dopo il caricamento del file video, il video viene codificato. Questo processo può richiedere del tempo, a seconda delle dimensioni del video e della complessità della codifica.

Puoi verificare lo stato di codifica di un video chiamando l’endpoint /videos/[VIDEO_ID] come descritto nella sezione recupera video.