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.

Creare un video richiede il permesso videos.create. Impostare visibility su public richiede anche videos.publish. Senza publish, il video viene creato come private. Vedi Autenticazione.

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 IA 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 tuo file video con una richiesta PUT all’URL firmato restituito nel passaggio precedente. Devi passare il mime type del file come header Content-Type. Puoi ottenere il mime type dal tuo file video locale tramite l’elemento file input.

Per i file di grandi dimensioni (oltre 100MB), consigliamo di usare il multipart upload, che offre maggiore affidabilità e supporta file fino a 60GB. Puoi anche usare la libreria Uppy per un’implementazione più semplice con chunking automatico e monitoraggio 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 della dimensione del video e della complessità della codifica.

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