ForHosting KIT · Video

Verifichi il formato video richiesto da ogni piattaforma

Un video può essere tecnicamente valido e adattarsi comunque male alla destinazione.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Questo strumento confronta il rapporto tra larghezza e altezza indicato con il riquadro fisso di una specifica posizione su una piattaforma social. Le comunica se la geometria coincide, se una sorgente più stretta richiederebbe bande laterali oppure se una sorgente più larga perderebbe i lati a causa del ritaglio. Non carica né decodifica il video: inserisca rapporto, piattaforma e posizione per ottenere una risposta deterministica adatta alla pianificazione, alla convalida o a un flusso di pubblicazione automatizzato.

Scelga la destinazione prima di valutare la sorgente

La conformità del rapporto riguarda una posizione, non soltanto il nome della piattaforma. Un normale video YouTube utilizza un riquadro orizzontale, mentre YouTube Shorts ne usa uno verticale. Instagram distingue inoltre tra feed verticale, feed quadrato, Reels e Stories. Selezioni la coppia esatta che rappresenta la destinazione del contenuto, quindi fornisca il rapporto visualizzato nel formato larghezza:altezza, per esempio 16:9, 9:16, 4:5 oppure 1:1. Sono ammessi componenti decimali per i formati meno comuni. Lo strumento normalizza in minuscolo le etichette di piattaforma e posizione, consulta il riquadro dichiarato e confronta i due valori numerici. Non esamina nome del file, risoluzione, tag di rotazione o flusso codificato. Se una registrazione telefonica contiene metadati di orientamento, determini le dimensioni dopo l’applicazione della rotazione e invii il rapporto effettivamente mostrato. Le combinazioni sconosciute vengono rifiutate esplicitamente, evitando che un’automazione applichi per errore una regola del feed a una storia o la convenzione di un’altra piattaforma.

Interpreti corrispondenza, bande e ritaglio

Un risultato di corrispondenza indica che sorgente e destinazione hanno la stessa forma matematica entro una minima tolleranza in virgola mobile. Non serve alcun adattamento geometrico. Un risultato con bande indica che la sorgente è più stretta del riquadro di destinazione. Conservarla interamente lascia spazio inutilizzato ai lati, fenomeno spesso chiamato pillarboxing, anche se l’API usa la categoria generale letterboxed. Un risultato di ritaglio indica che la sorgente è più larga della destinazione. Riempire il riquadro per tutta l’altezza rimuoverebbe contenuto dai bordi sinistro e destro. Queste etichette descrivono un adattamento geometrico centrato, non garantiscono il comportamento di ogni interfaccia di caricamento. Una piattaforma potrebbe offrire una nuova inquadratura manuale, uno sfondo sfocato, più rapporti o cambiare prodotto. Usi la risposta per stabilire se serve un controllo editoriale. Se è previsto un ritaglio, controlli soggetti, sottotitoli e loghi vicini ai bordi; con le bande, valuti uno sfondo progettato.

Esegua il controllo prima della pubblicazione

Controlli il contenuto appena viene assegnata una destinazione, prima di dedicare tempo al rendering finale, al caricamento o alla revisione multimediale. Un sistema editoriale può memorizzare piattaforma e posizione previste insieme al contenuto, calcolare il rapporto visualizzato da metadati affidabili e chiamare questa capacità come fase di convalida. Le corrispondenze esatte possono proseguire automaticamente. Gli altri risultati possono creare un’attività di revisione, selezionare una versione alternativa già pronta o inviare il contenuto a un calcolo di ritaglio separato. Conservi required_ratio nel registro di controllo affinché un editor capisca quale obiettivo ha guidato la decisione. La risposta ripete anche piattaforma, posizione e rapporto normalizzati, facilitando la lettura dei log quando una sorgente viene distribuita su diversi canali. Questa capacità non ridimensiona pixel, calcola aree sicure, prevede la compressione o afferma che un caricamento sarà rifiutato. Tramite API, ogni verifica deterministica costa $0.002 e non comporta trasferimento del video.

Convalidi i contenuti prima della programmazione

Segnali un formato incompatibile prima che la coda invii il video alla posizione selezionata.

Scelga la versione sorgente corretta

Confronti la sorgente con la destinazione e indirizzi il lavoro verso una versione orizzontale, quadrata, verticale o ritratto.

Crei una regola di revisione editoriale

Invii i ritagli al controllo dei bordi e i risultati con bande alla progettazione dello sfondo.

Che cosa significa una corrispondenza?

Il rapporto indicato ha la stessa forma numerica del requisito memorizzato per quella piattaforma e posizione.

Perché lo strumento indica la presenza di bande?

La sorgente è più stretta del riquadro; conservarla interamente lascerebbe bande o un altro sfondo ai lati.

Che cosa significa ritagliato in questo caso?

La sorgente è più larga della destinazione, quindi un riempimento centrato eliminerebbe parte dei lati sinistro e destro.

Lo strumento carica o modifica il video?

No. Confronta soltanto i rapporti e non riceve, decodifica, archivia, ridimensiona, ritaglia o transcodifica file multimediali.

Quanto costa una verifica tramite API?

Ogni richiesta API costa $0.002. Non viene applicato un costo variabile perché il video non viene trasferito.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/video/video-aspect-platform-check

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/video/video-aspect-platform-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ratio":"16:9","platform":"youtube","placement":"video"}'
{
  "ratio": "16:9",
  "platform": "youtube",
  "placement": "video"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.video_aspect_platform_check",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_mb500
max_minutes60
max_megapixels3.9
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →