Saltar al contenido principal
Hay algunos conceptos importantes que debes comprender al usar el endpoint POST /2/media/upload. Subir contenido multimedia con OAuth puede ser un poco complicado, por lo que hemos señalado algunas cosas que debes tener en cuenta, así como un ejemplo funcional de cómo usar este endpoint aquí.

Ten en cuenta

  • Puedes adjuntar hasta 4 fotos, 1 GIF animado o 1 vídeo en una Publicación.
  • La imagen enviada debe ser el binario sin procesar de la imagen o binario codificado en base64; no es necesario codificar ni escapar el contenido de otra forma siempre que el Content-Type esté configurado correctamente (en caso de duda: application/octet-stream).
  • Al publicar imágenes codificadas en base64, asegúrate de establecer “Content-Transfer-Encoding: base64” en la parte de la imagen del mensaje.
  • Los delimitadores de mensajes multiparte deben estar en su propia línea y terminar con un CRLF.
  • Para ver ejemplos funcionales de cómo hacer POST usando este endpoint, recomendamos hacer pruebas con xurl. También, revisa las bibliotecas de X disponibles.
  • Usa el media_id_string proporcionado en la respuesta de la API para JavaScript y cualquier otro lenguaje que no pueda representar con precisión un entero largo.

Categorías de medios

El parámetro de categoría de medios define el caso de uso del archivo multimedia que se va a cargar y puede afectar los límites de tamaño de archivo u otras restricciones aplicadas a las cargas de medios. Es importante utilizar la categoría de medios correcta al cargar contenido multimedia para evitar problemas al intentar usarlo. Es un valor opcional que se envía en la solicitud INIT como parte del flujo de carga. Si no se especifica la categoría de medios, se asume que el contenido cargado es para una Publicación (tweet_image, tweet_video o tweet_gif), según el tipo de contenido. Las categorías de medios más comunes son las siguientes:
  • tweet_image
  • tweet_video
  • tweet_gif
  • dm_image
  • dm_video
  • dm_gif
  • subtitles
Si eres socio de la Ads API, consulta esta documentación para obtener más información sobre la categoría de medios recomendada para video promocionado.

Especificaciones y recomendaciones para imágenes

Los archivos de imagen deben cumplir todos los siguientes criterios:
  • Tipos de medios de imagen admitidos: JPG, PNG, GIF, WEBP
  • Tamaño de la imagen: <= 5 MB
  • Tamaño del GIF animado: <= 15 MB
El límite de tamaño de archivo anterior lo impone el endpoint de carga de medios. Además, existe un límite de tamaño de archivo específico de la entidad de producto correspondiente que se aplica al llamar a los endpoints de creación de Publicación (o similares) con media_id. El límite de tamaño de archivo y otras restricciones pueden variar según el parámetro media_category.

Recomendaciones para GIF animados

Un GIF puede fallar durante la creación de la Publicación incluso si está dentro del límite de tamaño de archivo. Respeta las siguientes restricciones para mejorar las tasas de éxito.
  • Resolución: <= 1280x1080 (width x height)
  • Número de fotogramas: <= 350
  • Número de píxeles: <= 300 millones (width * height * num_frames)
  • Tamaño de archivo: <= 15 MB
Para procesar GIF más grandes, usa el endpoint de carga segmentada con el parámetro media_category. Esto permite que el servidor procese el archivo GIF de forma asíncrona, lo cual es un requisito para procesar archivos más grandes. Pasa media_category=tweet_gif para habilitar el comportamiento de carga asíncrona en Publicaciones con un GIF animado.

Especificaciones y recomendaciones de video

Utiliza Async Path para las cargas de contenido multimedia.
  • Códec de video: H264 High Profile
  • Frecuencias de fotogramas: 30 FPS, 60 FPS
  • Resolución de video: 1280x720 (horizontal), 720x1280 (vertical), 720x720 (cuadrado). Los usuarios con suscripción pueden subir un video en 1080p y obtener reproducción en 1080p. Los usuarios sin suscripción pueden subir un video en 720p y obtener reproducción en 720p.
  • Tasa de bits mínima de video: 5,000 kbps
  • Tasa de bits mínima de audio: 128 kbps
  • Códec de audio: AAC LC
  • Relación de aspecto: 16:9 (horizontal o vertical), 1:1 (cuadrado)

Avanzado

  • Frecuencia de fotogramas: debe ser de 60 FPS o menos
  • Dimensiones: deben estar entre 32x32 y 1280x1024
  • Tamaño de archivo: no debe superar los 512 MB
  • Duración: debe estar entre 0,5 segundos y 140 segundos
  • Relación de aspecto: debe estar entre 1:3 y 3:1
  • Relación de aspecto de píxel: debe ser de 1:1
  • Formato de píxel: solo se admite YUV 4:2:0
  • El audio debe ser AAC con perfil de baja complejidad. (AAC de alta eficiencia no es compatible)
  • El audio debe ser mono o stereo, no 5.1 ni superior
  • No debe tener open GOP
  • Debe usar progressive scan

Información adicional

En la siguiente tabla, cada fila representa una recomendación de carga, pero no es obligatoria. Todas las cargas se procesan para optimizarlas en múltiples plataformas. Para ver un ejemplo de cómo cargar contenido multimedia, consulta la documentación de carga de contenido multimedia por fragmentos.

Solución de problemas

Si tienes problemas con las Media APIs, revisa la categoría Media API en los foros para desarrolladores para encontrar una solución.