Specifiche video TikTok per il caricamento via API (2026)
Verificato il · fonti elencate in fondo a questa pagina
La Content Posting API di TikTok accetta tre content type video in caricamento: video/mp4, video/quicktime e video/webm. La durata massima non è un numero fisso: viene restituita per ogni creator come max_video_post_duration_sec dall’endpoint Query Creator Info, e va letta prima di ogni post.
Quali formati video accetta l’API di TikTok?
Sull’endpoint di caricamento sono documentati tre content type: video/mp4, video/quicktime e video/webm. In pratica l’MP4 con video H.264 e audio AAC è la scelta predefinita sicura: è la combinazione che TikTok transcodifica in modo più prevedibile.
| Content-Type | Contenitore | Nota |
|---|---|---|
| video/mp4 | .mp4 | Il predefinito. H.264 + AAC è l’accoppiata più prevedibile nella transcodifica di TikTok. |
| video/quicktime | .mov | Accettato. Di solito più pesante a parità di qualità, il che conta nel trasferimento, non per l’API. |
| video/webm | .webm | Accettato dall’API. Raramente è ciò che produce un telefono o un editor. |
Qual è la durata massima di un video TikTok tramite l’API?
Non c’è una risposta unica, ed è il dato più spesso riportato male sull’API di TikTok. Il meccanismo documentato è un campo, non una costante: max_video_post_duration_sec, restituito da Query Creator Info per l’account su cui stai per pubblicare.
Qualsiasi pagina che ti dà un solo numero per «la durata massima dei video nell’API di TikTok» descrive un singolo account, o tira a indovinare. L’implementazione corretta chiede per ogni account, per ogni post, e rifiuta il caricamento lato client quando il file è più lungo.
Come funziona il caricamento a blocchi?
Quando consegni a TikTok direttamente il file invece di un URL, la chiamata init riceve chunk_size e total_chunk_count, e il file viene trasferito a pezzi.
Il riferimento di caricamento di TikTok non pubblica limiti numerici per questi due parametri, quindi considera non verificata qualsiasi cifra precisa che leggi altrove. Ciò che la documentazione stabilisce è la struttura: dichiari la suddivisione in anticipo, poi trasferisci.
Perché il rapporto d’aspetto non compare nella documentazione dell’API?
Perché l’API non ne impone uno. Il 9:16 a 1080 × 1920 è una raccomandazione per la distribuzione, non un vincolo di caricamento: un file quadrato o orizzontale si carica senza problemi e poi viene riprodotto con le bande nere in un feed verticale a schermo intero, il che costa tempo di visione invece di restituire un errore.
È quindi l’unica specifica di questa pagina di cui nessuna risposta dell’API ti parlerà mai, ed è quella che incide di più sul rendimento del video.
Domande frequenti
- Quali formati video accetta la Content Posting API di TikTok?
- Sono documentati tre content type: video/mp4, video/quicktime e video/webm. L’MP4 con H.264 e AAC è la scelta più prevedibile.
- Qual è la durata massima di un video che posso pubblicare tramite l’API di TikTok?
- Varia da account ad account. L’endpoint Query Creator Info restituisce max_video_post_duration_sec per ogni creator, e quel valore è il limite per quell’account. Non esiste un numero unico pubblicato.
- L’API di TikTok rifiuta un video che non è in 9:16?
- No. Il rapporto d’aspetto non è un vincolo di caricamento. Un video non verticale si carica senza problemi e poi viene riprodotto con le bande in un feed verticale, il che di solito riduce il tempo di visione.
- Perché il mio video TikTok pubblicato via API è visibile solo a me?
- Perché i contenuti pubblicati da un client API non verificato sono limitati alla visibilità privata. La restrizione viene tolta quando il client supera l’audit di TikTok, non cambiando il campo della privacy.
Fonti
- TikTok for Developers — Content Posting API, Upload Video — consultate il .
- TikTok for Developers — Query Creator Info — consultate il .
- TikTok for Developers — Content Posting API, Direct Post — consultate il .
Questi dati provengono dalla documentazione di un’altra azienda, che può cambiare senza preavviso e che qui nulla verifica in automatico. Per questo ogni fonte riporta la data in cui è stata letta. Le fonti di questa pagina vengono rilette ogni trimestre.
Come è stata fatta questa pagina: scritta con l’aiuto dell’IA a partire dalle fonti citate in questa pagina, consultate il .