Verifichi il formato video richiesto da ogni piattaforma
Un video può essere tecnicamente valido e adattarsi comunque male alla destinazione.
Esegui gratis nel browser
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.
Casi d'uso
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.
Domande frequenti
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.
Per sviluppatori — accesso via API
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.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
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"}'const res = await fetch("https://api.kit.forhosting.com/video/video-aspect-platform-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video/video-aspect-platform-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/video-aspect-platform-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"ratio":"16:9","platform":"youtube","placement":"video"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"ratio":"16:9","platform":"youtube","placement":"video"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/video-aspect-platform-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
}Esempio di risposta
{
"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.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 500 |
max_minutes | 60 |
max_megapixels | 3.9 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |