Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Requisitos de video de la API de TikTok: formato, tamaño y duración

Un video publicado a través de la API for Business de TikTok debe ser un archivo MP4, MOV o WebM de hasta 1 GB, de entre 3 y 600 segundos de duración (o el máximo de la cuenta, si es menor), con al menos 360 píxeles de alto y de ancho y una velocidad de 23 a 60 fotogramas por segundo. TikTok descarga el archivo por su cuenta, así que la URL del video debe estar en un dominio o prefijo de URL que la app que publica haya verificado.

easyCoexistence publica videos en TikTok con publish_tiktok_post desde Claude, ChatGPT o tu propio código: pasas un enlace HTTPS al archivo, la descripción y si los comentarios están activados, y easyCoexistence entrega el archivo a TikTok desde su propia ruta de medios verificada.

1 GB

Tamaño máximo de video que acepta el endpoint de publicación, en un contenedor MP4, MOV o WebM.

3 to 600 s

Duración mínima y máxima de video que TikTok documenta para publicar a través de la API.

360 px

Alto y ancho mínimos de un video publicado, que además debe tener de 23 a 60 fotogramas por segundo.

30 min

Tiempo mínimo que TikTok recomienda que la URL del video siga activa, ya que TikTok descarga el archivo por su cuenta.

¿Qué requisitos debe cumplir un video?

La especificación de TikTok para un video publicado mediante POST /business/video/publish/, que TikTok comprueba una vez descargado el archivo:

  • Contenedor: MP4, MOV o WebM.
  • Tamaño: hasta 1 GB.
  • Duración: al menos 3 segundos y como máximo 600, o menos si el máximo propio de la cuenta es inferior.
  • Imagen: al menos 360 píxeles de alto y de ancho.
  • Velocidad de fotogramas: de 23 a 60 fotogramas por segundo.

¿Todas las cuentas pueden publicar videos de 600 segundos?

No siempre. GET /business/video/settings/ devuelve max_video_post_duration_sec, la duración máxima de video que puede publicar esa cuenta, y un video más largo falla al publicarse. La misma llamada indica si la configuración de la cuenta permite comentarios, Duets y Stitch en sus publicaciones. Con easyCoexistence, tu propio código la consulta con el token y el business_id de get_social_credentials.

¿Dónde tiene que estar alojado el video?

En una URL HTTP o HTTPS pública, que TikTok descarga por su cuenta y que recomienda mantener activa durante al menos 30 minutos. Desde el 16 de noviembre de 2023, TikTok también rechaza las URL de video no verificadas: el desarrollador demuestra que es propietario de un dominio con un registro DNS TXT, o de un prefijo de URL con un archivo de firma alojado bajo ese prefijo, y a partir de ahí se puede publicar desde cualquier URL que empiece por un prefijo verificado.

¿Cómo hace llegar easyCoexistence tu archivo a TikTok?

Mediante su propio prefijo de URL verificado. publish_tiktok_post recibe tu enlace HTTPS, entrega a TikTok un enlace firmado bajo la ruta de medios de easyCoexistence que caduca a las 6 horas y, cuando TikTok lo descarga, transmite el archivo desde tu enlace sin almacenar nada por el camino. Tu enlace no necesita verificación propia, pero tiene que ser HTTPS y abrirse sin iniciar sesión hasta que la publicación esté completada.

¿Qué pasa después de que TikTok descarga el video?

TikTok revisa el archivo y lo transcodifica, y advierte que la publicación puede mostrarse con una resolución y una tasa de bits menores que las del original, según el dispositivo y la red de quien la vea. Un archivo que incumple alguna regla no se publica: su estado aparece como FAILED con un motivo como file_format_check_failed, frame_rate_check_failed o picture_size_check_failed, y TikTok indica que estos errores no se pueden reintentar con el mismo archivo.

Errores comunes

  • Enviar un enlace http://. publish_tiktok_post solo acepta enlaces HTTPS y rechaza la llamada antes de que llegue a TikTok.
  • Exportar a menos de 23 fotogramas por segundo. TikTok descarga el archivo, detecta que la velocidad de fotogramas es demasiado baja y la publicación falla con frame_rate_check_failed.
  • Dar por hecho que todas las cuentas admiten 600 segundos. Un video más largo que el max_video_post_duration_sec de la cuenta falla, así que compruébalo antes.
  • Retirar el archivo justo después de la llamada. TikTok lo descarga después de aceptar la petición, y si el enlace deja de funcionar, la publicación falla con video_pull_failed.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, un precio que baja a medida que agregas conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Qué formatos de video acepta la API de TikTok?

Archivos MP4, MOV y WebM de hasta 1 GB, de 3 a 600 segundos de duración, con al menos 360 píxeles por lado y de 23 a 60 fotogramas por segundo.

¿Puedo subir un video desde mi computadora?

No con este endpoint. Recibe un parámetro video_url y descarga el archivo desde ahí, así que antes el video necesita un enlace HTTPS público.

¿Por qué TikTok exige una URL verificada?

TikTok explica que verificar la propiedad de la URL le ayuda a cumplir sus políticas sobre contenido protegido por derechos de autor y seguridad de los usuarios, y desde el 16 de noviembre de 2023 rechaza las URL de video no verificadas.

¿TikTok reduce la calidad de los videos publicados con la API?

Puede hacerlo. TikTok transcodifica el video, y la publicación puede mostrarse con una resolución y una tasa de bits menores que las del archivo, según el dispositivo y la conexión de quien la vea.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el