Vai al contenuto principale

Trova il prossimo strumento

Documentazione/API/API Media: conversione di video e audio
API

API Media: conversione di video e audio

Comprimi, converti, taglia, ridimensiona e silenzia video, trasformali in GIF e converti o comprimi audio tramite l'endpoint media.

Risposta breve

Carica il file con un caricamento diretto, poi invia POST /api/v1/media/process/ con l'objectKey come sourceKey, un'operation (convert, compress-video, compress-audio, trim-video, trim-audio, resize-video, change-video-speed, mute-video, video-to-gif, gif-to-mp4) e il formato di destinazione. Interroga il job restituito. I caricamenti sono limitati a 50 MB per file.

Operazioni e opzioni

Input: MP4, MOV, MKV, AVI, WebM, MP3, WAV, M4A, FLAC, OGG, AAC e GIF.

operationCampi utili
convertformat: mp4, webm, mkv, mp3, wav, flac, m4a, ogg, aac, gif
compress-videocrf (18–40, più alto = file più piccolo) oppure targetMb per una dimensione obiettivo
compress-audiobitrate, ad es. "128k"
trim-video / trim-audiostart e duration in secondi
resize-video / change-video-resolutionwidth, height
change-video-speedspeed, ad es. 1.5
mute-video, video-to-gif, gif-to-mp4format; duration per la durata della GIF

Comprimere un video

Misurato in produzione: un MP4 720p di 10 secondi da 2,5 MB è tornato come file H.264/AAC da 1,6 MB in circa 19 secondi. I video lunghi o ad alto bitrate richiedono un tempo proporzionalmente maggiore.

curl -X POST 'https://maxscanner.app/api/v1/media/process/' \
  -H "Authorization: Bearer $MAXSCANNER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{ "operation": "compress-video", "sourceKey": "users/<id>/media/inbox/…-clip.mp4", "filename": "clip.mp4", "format": "mp4" }'

Consigli pratici

  • Interroga i job media meno spesso (ogni 10 secondi) e prevedi diversi minuti per i video lunghi
  • Preferisci l’output MP4: si riproduce ovunque e, con questa API, di solito è più leggero di WebM, che viene codificato privilegiando la velocità
  • Taglia prima di comprimere, per risparmiare tempo
  • Controlla GET /api/v1/media/health/ prima di un batch consistente: indica se il worker media è disponibile

Domande frequenti

Qual è il video più grande che posso elaborare?

Oggi 50 MB per caricamento. Il worker media in sé accetta fino a 500 MB, quindi contatta il supporto se ti servono file più grandi.

L'audio viene mantenuto quando comprimo un video?

Sì, in formato AAC, a meno che tu non usi mute-video.

Guide correlate