Video Metadata (ffprobe)

action_video_metadata · action · Utility · Disponibile · v1.1.0

Descrizione

Estrai metadata video (codec, bitrate, fps, risoluzione, traccia audio, traccia sottotitoli, durata, container) via ffprobe HTTP wrapper. Casi d'uso tipici: indicizzazione media library (catalogazione automatica file caricati), QA pre-publish (verifica audio italiano + 1080p min), check size pre-CDN upload, compliance broadcast (FCC/AGCOM richiede metadata standard), pipeline transcoding (sapere codec sorgente per scegliere preset output). Pattern deployment: ffprobe binary + dipendenze codec pesa ~50MB → non lo bundliamo nel runtime. Il tenant deploya un wrapper HTTP (es. immagine `jrottenberg/ffmpeg` + Express) e configura l'endpoint qui o via env `FLOWFORGE_FFPROBE_ENDPOINT`. SSRF-safe via @flowforge/safe-fetch quando l'URL video viene da config esterna.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

Campo	Tipo	Required	Default	Descrizione
`endpoint` ffprobe endpoint HTTP	`string`	no	— http://ffprobe.internal:8080	URL del wrapper ffprobe HTTP. Lascia VUOTO per usare la env `FLOWFORGE_FFPROBE_ENDPOINT` (consigliato in produzione: 1 wrapper condiviso). Esempio container locale: `docker run -d -p 8080:8080 jrottenberg/ffmpeg-http`. Deve esporre `POST /probe` con body `{ url\|data }` e ritornare JSON ffprobe standard.
`apiKey` API Key wrapper (opzionale)	`string (encrypted)`	no	— {{secrets.FFPROBE_API_KEY}}	Bearer token se il wrapper richiede autenticazione. Lascia vuoto per wrapper interno senza auth. NON inserire mai una chiave in plain — usa il riferimento a Credentials.
`inputType` Sorgente video	`enum` `urlinputbase64`	no	`url`	url = URL HTTP pubblico che il wrapper scaricherà. input = legge `url` o `dataBase64` dall'output del nodo precedente (es. download da S3, file_read). base64 = dati video inline (max 10MB consigliato, oltre usa URL).
`url` URL video	`string`	no	— https://cdn.miosito.com/video.mp4 / {{$node.s3_download.json.url}}	URL completo HTTP/HTTPS del file video. Supporta MP4, MOV, MKV, WebM, AVI, HLS .m3u8, DASH .mpd. Per HLS/DASH ffprobe estrae metadata del playlist (variant streams). SSRF-block automatic: IP interni e localhost bloccati.
`dataBase64` Video base64	`string (multiline)`	no	— AAAAIGZ0eXBpc29tAAACAGlzb21pc28y…	Contenuto video encoded base64 SENZA il prefisso "data:video/mp4;base64,". Limite raccomandato 10MB (oltre ffprobe HTTP timeout). Per file più grandi preferire `url` o `input`.

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

duration
bitRate
formatName
size
videoCodec
videoWidth
videoHeight
videoFps
audioTracks
audioCodecs
audioLanguages
subtitleTracks
subtitleLanguages
raw

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-action_video_metadata-1",
  "defId": "action_video_metadata",
  "label": "Video Metadata (ffprobe)",
  "config": {
    "inputType": "url"
  }
}

🔗 Nodi correlati nella stessa categoria

Pronto a usare Video Metadata (ffprobe)?

Disponibile da subito in tutti i piani FlowForge. Provalo gratis senza carta di credito.

Inizia gratis Sfoglia tutti i nodi