Cómo definir la portada de un Reel con la API de Instagram
La API de Instagram define la portada de un Reel de una de dos maneras al crear el contenedor: cover_url apunta a una imagen JPEG que se usa como portada en la pestaña Reels, o thumb_offset elige un fotograma del video, en milisegundos desde el inicio. Si no se envía ninguno, se usa el primer fotograma, y si se envían los dos, prevalece cover_url.
easyCoexistence publica Reels con publish_instagram_post desde Claude, ChatGPT o tu propio código.
Tamaño máximo de portada de Reels; debe ser JPEG, y los demás espacios de color se convierten a sRGB.
Forma de portada que recomienda Meta; las demás formas se recortan a su rectángulo central de 9:16.
El cuadrado central que Meta recorta de la portada cuando el Reel se comparte en el Feed.
thumb_offset predeterminado, que hace que el primer fotograma del video sea la miniatura.
Subcódigo de error para un thumb_offset menor que 0 o no menor que la duración del video.
¿Cómo se define la portada de un Reel?
En el contenedor del Reel. POST /<IG_ID>/media con media_type REELS y video_url también acepta cover_url, la URL pública de una imagen que Meta descarga y usa como portada en la pestaña Reels, o thumb_offset, la posición en milisegundos del fotograma que se usará. La portada pertenece al contenedor, así que se elige antes de publicar el Reel.
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json
{
"media_type": "REELS",
"video_url": "https://example.com/reel.mp4",
"caption": "<CAPTION>",
"cover_url": "https://example.com/cover.jpg"
}¿Qué debe ser la imagen de portada?
La especificación de Meta para una foto de portada de Reels, que la imagen en cover_url debe cumplir:
- Formato: JPEG.
- Tamaño de archivo: hasta 8 MB.
- Espacio de color: sRGB; las imágenes en otros espacios de color se convierten.
- Relación de aspecto: 9:16 recomendada, para evitar recortes o espacios en blanco.
- Ubicación: un servidor público, ya que Meta descarga la imagen desde la URL por sí misma.
¿Cómo se recorta la portada?
Desde el centro. Cuando la imagen no es 9:16, Meta la recorta y usa el rectángulo central de 9:16 como portada del Reel; y cuando el Reel se comparte en el Feed, el cuadrado central 1:1 se convierte en la portada de la publicación del Feed. Mantener rostros y texto cerca del centro hace que ambos recortes los muestren.
¿Cómo funciona thumb_offset?
Indica un momento del video, en milisegundos, cuyo fotograma se convierte en la miniatura; el valor predeterminado, 0, es el primer fotograma. El valor debe ser 0 o mayor y menor que la duración del video, o la petición falla con el código 1, subcódigo 2207057. thumb_offset también se aplica a los contenedores de video, y en un Reel que además tiene cover_url, Meta lo ignora.
¿Se puede leer o cambiar la portada después?
Leerla, sí: un Reel publicado informa media_type VIDEO, y su campo thumbnail_url devuelve la imagen en miniatura del medio. Cambiarla es otra cuestión, ya que la única actualización que Meta documenta para medios publicados activa o desactiva los comentarios, así que la portada queda fijada al crear el contenedor.
Errores comunes
- Enviar cover_url y thumb_offset juntos esperando el fotograma. Meta usa cover_url e ignora thumb_offset.
- Dar thumb_offset en segundos. Se cuenta en milisegundos, y un valor igual o mayor que la duración del video falla con el subcódigo 2207057.
- Subir una portada en PNG. La portada de un Reel debe ser JPEG de hasta 8 MB.
- Colocar el sujeto en el borde de la portada. Meta conserva el 9:16 central de la imagen, y solo el cuadrado central en el Feed.
La herramienta no acepta cover_url ni thumb_offset, así que el Reel sale con el fotograma que elige Instagram, y se escoge otra portada en la app de Instagram. De US$ 9 a US$ 0.75 por conexión al mes, bajando al sumar conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Puedo subir una portada personalizada para un Reel por la API?
Sí. Envía cover_url con la URL pública de un JPEG de hasta 8 MB al crear el contenedor del Reel.
¿La portada de un Reel debe ser sRGB?
Debería serlo. La especificación de Meta pide sRGB y convierte las imágenes en otros espacios de color, y la portada debe ser un JPEG de hasta 8 MB.
¿Qué significa el error 2207057 en un Reel de Instagram?
El thumb_offset del Reel está fuera de rango, dentro del código 1: debe ser al menos 0 y menor que la duración del video, contado en milisegundos, así que 5 segundos después es 5000.
¿Qué pasa si envío cover_url y thumb_offset a la vez?
Meta usa la imagen de cover_url e ignora thumb_offset.
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