Requisiti dei video per l'API di TikTok: formato, dimensioni e durata
Un video pubblicato tramite l'API for Business di TikTok deve essere un file MP4, MOV o WebM fino a 1 GB, lungo da 3 a 600 secondi (o il limite inferiore dell'account), con altezza e larghezza di almeno 360 pixel, a da 23 a 60 fotogrammi al secondo. TikTok scarica il file da sé, quindi l'URL del video deve trovarsi su un dominio o prefisso URL che l'app di pubblicazione ha verificato.
easyCoexistence pubblica video TikTok con publish_tiktok_post da Claude, ChatGPT o dal tuo codice: passi un link HTTPS al file, la didascalia e se i commenti sono attivi, e il file viene servito a TikTok dal proprio percorso multimediale verificato.
Il video più grande che l'endpoint di pubblicazione accetta, in un contenitore MP4, MOV o WebM.
Durata minima e massima del video che TikTok documenta per la pubblicazione tramite l'API.
Altezza e larghezza minime di un video pubblicato, che richiede anche da 23 a 60 fotogrammi al secondo.
Tempo minimo che TikTok consiglia di mantenere valido l'URL del video, poiché TikTok scarica il file da sé.
Cosa deve rispettare un video?
La specifica di TikTok per un video pubblicato tramite POST /business/video/publish/, che TikTok verifica dopo aver scaricato il file:
- Contenitore: MP4, MOV o WebM.
- Dimensione: fino a 1 GB.
- Durata: almeno 3 secondi e al massimo 600, oppure meno se il limite dell'account è inferiore.
- Immagine: almeno 360 pixel in altezza e in larghezza.
- Frequenza dei fotogrammi: da 23 a 60 fotogrammi al secondo.
Ogni account può pubblicare video da 600 secondi?
Non sempre. GET /business/video/settings/ restituisce max_video_post_duration_sec, cioè il video più lungo che l'account può pubblicare, e uno più lungo non viene pubblicato. La stessa chiamata indica se le impostazioni dell'account consentono commenti, Duets e Stitch sui suoi post. Con easyCoexistence, il tuo codice legge queste informazioni con il token e il business_id di get_social_credentials.
Dove deve trovarsi il video?
A un URL HTTP o HTTPS pubblico, che TikTok recupera da sé e che consiglia di mantenere valido per almeno 30 minuti. Dal 16 novembre 2023 TikTok rifiuta anche gli URL video non verificati: lo sviluppatore dimostra la proprietà di un dominio con un record DNS TXT, oppure di un prefisso URL con un file di firma collocato sotto di esso, e qualsiasi URL che inizia con un prefisso verificato può poi essere pubblicato.
Come fa easyCoexistence a far arrivare il file a TikTok?
Tramite il proprio prefisso URL verificato. publish_tiktok_post prende il tuo link HTTPS, consegna a TikTok un link firmato sul percorso multimediale di easyCoexistence che scade dopo 6 ore, e trasmette il file dal tuo link quando TikTok lo scarica, senza memorizzare nulla nel mezzo. Il tuo link non richiede una verifica propria, ma deve essere HTTPS e aperto senza login fino alla pubblicazione del post.
Cosa succede dopo che TikTok scarica il video?
TikTok controlla il file e lo ricodifica, e segnala che il post pubblicato può mostrare una risoluzione e un bit rate inferiori all'originale, a seconda del dispositivo e della rete dello spettatore. Un file che viola una regola non viene pubblicato: il suo stato risulta FAILED con un motivo come file_format_check_failed, frame_rate_check_failed o picture_size_check_failed, e TikTok indica che questi errori non sono ritentabili con lo stesso file.
Errori comuni
- Inviare un link http://. publish_tiktok_post accetta solo link HTTPS e rifiuta la chiamata prima che TikTok la riceva.
- Esportare sotto i 23 fotogrammi al secondo. TikTok scarica il file, trova la frequenza troppo bassa e fa fallire il post con frame_rate_check_failed.
- Supporre 600 secondi per ogni account. Un video più lungo di max_video_post_duration_sec dell'account fallisce, quindi controllalo prima.
- Rimuovere il file subito dopo la chiamata. TikTok lo scarica dopo aver accettato la richiesta, e un link che smette di funzionare fa fallire il post con video_pull_failed.
Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
Quali formati video accetta l'API di TikTok?
File MP4, MOV e WebM fino a 1 GB, lunghi da 3 a 600 secondi, di almeno 360 pixel per lato e da 23 a 60 fotogrammi al secondo.
Posso caricare un file video dal mio computer?
Non con questo endpoint. Accetta un video_url e scarica il file da lì, quindi il video deve prima avere un link HTTPS pubblico.
Perché TikTok vuole un URL verificato?
TikTok afferma che la verifica della proprietà dell'URL la aiuta a rispettare le sue politiche su contenuti protetti da copyright e sulla sicurezza degli utenti, e dal 16 novembre 2023 rifiuta gli URL video non verificati.
TikTok riduce la qualità di un video pubblicato tramite API?
Può accadere. TikTok ricodifica il video, e il post può mostrare una risoluzione e un bit rate inferiori al file, a seconda del dispositivo e della connessione dello spettatore.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il