Al publicar un inmueble, WordPress manda sus fotos y la locución a ReelSDK y un webhook firmado guarda el MP4 en la biblioteca. Un vídeo de 5 fotos y 14 s cuesta menos de 0,007 USD, y una cuenta nueva trae 0,50 USD gratis.

Vídeos automáticos desde WordPress, del inmueble publicado al MP4 vertical

Un solo archivo PHP en mu-plugins y ningún plugin de pago: el editor publica, ReelSDK tarda unos 20 s en montar 5 fotos y la locución, y el vídeo aparece adjunto al anuncio.

En españolActualizado

5 fotos del anuncio con locución en español y subtítulos bold: 14 s de vídeo, listo en unos 20 segundos.Entrada: locución en MP3

La petición

POST /v1/slideshow

Un mu-plugin de PHP convierte cada inmueble que publicas en WordPress en un vídeo vertical con locución y subtítulos.

terminalTry it
curl "https://api.reelsdk.com/v1/slideshow?wait=60" \
  -H "Authorization: Bearer $REELSDK_KEY" \
  --json '{
    "images": [
      "https://api.reelsdk.com/f/lib/in/listing-villa/exterior.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/pool.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/living-room.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/kitchen.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/bedroom.jpg"
    ],
    "size": "9:16",
    "fit": "contain",
    "motion": "kenburns",
    "voiceover": "https://api.reelsdk.com/f/lib/in/es/villa-wordpress.mp3",
    "language": "es",
    "captions": "bold"
  }'
request.mjsTry it
const res = await fetch("https://api.reelsdk.com/v1/slideshow?wait=60", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.REELSDK_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "images": [
      "https://api.reelsdk.com/f/lib/in/listing-villa/exterior.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/pool.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/living-room.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/kitchen.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/bedroom.jpg"
    ],
    "size": "9:16",
    "fit": "contain",
    "motion": "kenburns",
    "voiceover": "https://api.reelsdk.com/f/lib/in/es/villa-wordpress.mp3",
    "language": "es",
    "captions": "bold"
  }),
});
const { job } = await res.json();
response.json
{
  "job": {
    "id": "job_kahdrmsv2vku0339pp7v",
    "op": "slideshow",
    "status": "succeeded",
    "created_at": "2026-11-07T04:04:10.425Z",
    "finished_at": "2026-11-07T04:04:30.228Z",
    "outputs": {
      "video": "https://api.reelsdk.com/f/out/job_kahdrmsv2vku0339pp7v/video.mp4?s=...",
      "transcript": "https://api.reelsdk.com/f/out/job_kahdrmsv2vku0339pp7v/transcript.json?s=...",
      "srt": "https://api.reelsdk.com/f/out/job_kahdrmsv2vku0339pp7v/captions.srt?s=...",
      "vtt": "https://api.reelsdk.com/f/out/job_kahdrmsv2vku0339pp7v/captions.vtt?s=...",
      "ass": "https://api.reelsdk.com/f/out/job_kahdrmsv2vku0339pp7v/captions.ass?s=..."
    },
    "duration_s": 13.967,
    "usage": {
      "output_seconds": 13.967,
      "audio_seconds": 13.468,
      "tts_characters": 0,
      "images": 0
    },
    "poll_url": "https://api.reelsdk.com/v1/jobs/job_kahdrmsv2vku0339pp7v"
  }
}

Del inmueble publicado al vídeo

El mu-plugin engancha transition_post_status y, cuando un inmueble pasa a publicado, programa una tarea con wp_schedule_single_event. Esa tarea reúne las fotos adjuntas al anuncio y la URL del MP3 del campo locucion_mp3, y llama a POST /v1/slideshow?wait=0 con wp_remote_post: la API contesta al momento con el id del trabajo, que se guarda en _reelsdk_job.

Cambia inmueble por el tipo de entrada de tu tema, como property o estate_property, y si tu tema guarda la galería en un campo propio en vez de adjuntar las fotos al anuncio, cambia la línea de get_attached_media. La cabecera Idempotency-Key une el ID del inmueble y un hash MD5 del cuerpo: si el mismo anuncio se publica dos veces con las mismas fotos en 24 h, la API devuelve el mismo trabajo en lugar de cobrarte otro, y si cambian las fotos sale un vídeo nuevo.

wp-config.php
// wp-config.php, antes de require_once ABSPATH . 'wp-settings.php';
define( 'REELSDK_KEY', 'rsdk_live_...' );
define( 'REELSDK_WEBHOOK_SECRET', 'whsec_...' );
wp-content/mu-plugins/reelsdk-inmuebles.phpTry it
<?php
/**
 * Plugin Name: Vídeos de inmuebles con ReelSDK
 */

// Al publicar solo se programa el trabajo, así el editor no espera al render
add_action( 'transition_post_status', function ( $nuevo, $anterior, $post ) {
	$publicado = 'publish' === $nuevo && 'publish' !== $anterior;
	if ( $publicado && 'inmueble' === $post->post_type ) {
		wp_schedule_single_event( time(), 'reelsdk_crear_video', array( $post->ID ) );
	}
}, 10, 3 );

add_action( 'reelsdk_crear_video', function ( $post_id ) {
	$ids   = array_keys( get_attached_media( 'image', $post_id ) );
	$fotos = array_values( array_filter( array_map( 'wp_get_attachment_url', $ids ) ) );
	if ( ! $fotos ) {
		return;
	}

	$cuerpo = array(
		'images'      => array_slice( $fotos, 0, 10 ),
		'size'        => '9:16',
		'fit'         => 'contain',
		'motion'      => 'kenburns',
		'webhook_url' => rest_url( 'reelsdk/v1/webhook' ),
	);

	// Con locución, la voz marca la duración y se subtitula; sin ella, 3 s por foto y música
	$locucion = get_post_meta( $post_id, 'locucion_mp3', true );
	if ( $locucion ) {
		$cuerpo += array( 'voiceover' => $locucion, 'language' => 'es', 'captions' => 'bold' );
	} else {
		$cuerpo += array( 'seconds_per_image' => 3, 'music' => 'https://api.reelsdk.com/f/lib/music/chill/calm-currents.mp3' );
	}

	// Mismo inmueble y mismas fotos: misma clave, así un segundo envío no cobra otro vídeo
	$json      = wp_json_encode( $cuerpo );
	$respuesta = wp_remote_post( 'https://api.reelsdk.com/v1/slideshow?wait=0', array(
		'timeout' => 15,
		'headers' => array(
			'Authorization'   => 'Bearer ' . REELSDK_KEY,
			'Content-Type'    => 'application/json',
			'Idempotency-Key' => 'inmueble-' . $post_id . '-' . md5( $json ),
		),
		'body'    => $json,
	) );

	$datos = json_decode( wp_remote_retrieve_body( $respuesta ), true );
	if ( is_wp_error( $respuesta ) || empty( $datos['job']['id'] ) ) {
		$motivo = is_wp_error( $respuesta ) ? $respuesta->get_error_message() : wp_remote_retrieve_body( $respuesta );
		error_log( 'reelsdk: no se pudo crear el vídeo del inmueble ' . $post_id . ': ' . $motivo );
		return;
	}
	update_post_meta( $post_id, '_reelsdk_job', $datos['job']['id'] );
} );

add_action( 'rest_api_init', function () {
	register_rest_route( 'reelsdk/v1', '/webhook', array(
		'methods'             => 'POST',
		'permission_callback' => 'reelsdk_firma_valida',
		'callback'            => 'reelsdk_aviso',
	) );
} );

function reelsdk_firma_valida( WP_REST_Request $request ) {
	parse_str( str_replace( ',', '&', (string) $request->get_header( 'reelsdk-signature' ) ), $partes );
	$t  = $partes['t'] ?? '';
	$v1 = $partes['v1'] ?? '';
	if ( ! is_string( $t ) || ! is_string( $v1 ) || ! ctype_digit( $t ) || abs( time() - (int) $t ) > 300 ) {
		return false;
	}

	$esperada = hash_hmac( 'sha256', $t . '.' . $request->get_body(), REELSDK_WEBHOOK_SECRET );
	return hash_equals( $esperada, $v1 );
}

// Se contesta al momento: cada aviso espera 15 s como mucho y la descarga va aparte
function reelsdk_aviso( WP_REST_Request $request ) {
	$job = json_decode( $request->get_body(), true );
	if ( 'succeeded' === ( $job['status'] ?? '' ) ) {
		wp_schedule_single_event( time(), 'reelsdk_guardar_video', array( $job['id'], $job['outputs']['video'] ) );
	}
	return new WP_REST_Response( null, 204 );
}

add_action( 'reelsdk_guardar_video', function ( $job_id, $url ) {
	$inmuebles = get_posts( array(
		'post_type'  => 'inmueble',
		'meta_key'   => '_reelsdk_job',
		'meta_value' => $job_id,
		'fields'     => 'ids',
	) );
	$post_id = $inmuebles[0] ?? 0;
	if ( ! $post_id || get_post_meta( $post_id, '_reelsdk_video', true ) ) {
		return;
	}

	require_once ABSPATH . 'wp-admin/includes/file.php';
	require_once ABSPATH . 'wp-admin/includes/media.php';
	require_once ABSPATH . 'wp-admin/includes/image.php';

	// Los enlaces de ReelSDK caducan a los 7 días, así que el MP4 se queda en la biblioteca de medios
	$tmp = download_url( $url );
	if ( is_wp_error( $tmp ) ) {
		error_log( 'reelsdk: no se pudo descargar ' . $job_id . ': ' . $tmp->get_error_message() );
		return;
	}

	$video = media_handle_sideload( array( 'name' => 'inmueble-' . $post_id . '.mp4', 'tmp_name' => $tmp ), $post_id );
	if ( is_wp_error( $video ) ) {
		wp_delete_file( $tmp );
		error_log( 'reelsdk: no se pudo guardar el vídeo de ' . $job_id . ': ' . $video->get_error_message() );
		return;
	}
	update_post_meta( $post_id, '_reelsdk_video', $video );
}, 10, 2 );

De un vistazo

Qué hace cada parte del mu-plugin

Qué hace cada parte del mu-plugin
Gancho o funciónCuándo se ejecutaQué hace
transition_post_statusAl pasar el inmueble a publicadoPrograma el trabajo con wp_schedule_single_event para que el editor no espere
wp_remote_postEn la siguiente pasada de WP-CronManda fotos y locución a POST /v1/slideshow?wait=0 con una Idempotency-Key por inmueble y contenido
register_rest_routeCuando ReelSDK avisaAbre la ruta /wp-json/reelsdk/v1/webhook
hash_hmac y hash_equalsAntes de aceptar el avisoComprueban la firma Reelsdk-Signature y descartan las de más de 300 s
download_url y media_handle_sideloadEn segundo plano, tras el avisoGuardan el MP4 en la biblioteca de medios, adjunto al inmueble

Fuentes: ReelSDK webhooks docs, WordPress: wp_remote_post(), WordPress: register_rest_route(), WordPress: media_handle_sideload(), revisado en noviembre de 2026.

La locución en español

Las 40 voces de texto a voz de POST /v1/slideshow hablan inglés, así que la voz en español va como MP3: la grabas o la generas con un servicio de voz y pegas su URL en el campo locucion_mp3. La de nuestro ejemplo dura unos 13 segundos y la generamos con ElevenLabs.

Con locución, la API reparte las fotos a lo largo de la voz, añade 0,5 s al final y transcribe el audio para los subtítulos bold. Con fit en contain, las fotos horizontales salen enteras sobre una copia desenfocada de sí mismas. Sin MP3, el plugin pone 3 s por foto y una pista de música de la biblioteca de ReelSDK; tienes más opciones de ritmo y música en vídeo con fotos.

El webhook: firma, respuesta rápida y reintentos

Cuando el vídeo termina, ReelSDK manda un POST a /wp-json/reelsdk/v1/webhook con el trabajo en JSON y la cabecera Reelsdk-Signature: t=...,v1=.... El permission_callback calcula el HMAC-SHA256 de t.cuerpo con tu secreto whsec_, lo compara con hash_equals y rechaza las firmas de más de 300 s.

Cada intento espera 15 s como mucho, y cualquier respuesta que no sea 2xx, redirecciones 3xx incluidas, cuenta como fallo. Por eso el plugin contesta 204 al instante y deja la descarga del MP4 para otra tarea. Si tu web no responde, ReelSDK lo intenta hasta 6 veces en unas 7 h, y siempre puedes consultar el trabajo con GET /v1/jobs/{id}.

El vídeo, dentro de WordPress

La tarea reelsdk_guardar_video busca el inmueble por _reelsdk_job, descarga el MP4 con download_url y lo mete en la biblioteca de medios con media_handle_sideload, adjunto al anuncio. Tiene que quedarse en tu web porque los enlaces de ReelSDK caducan a los 7 días. WP-Cron solo se ejecuta cuando alguien visita la web, así que si tienes poco tráfico conviene lanzarlo con un cron del servidor.

Este vídeo de 5 fotos y 14 s costó menos de 0,007 USD: se paga a 0,03 USD por minuto de vídeo y la locución no suma nada porque el MP3 es tuyo. Para subtitular también los vídeos que grabas con el móvil en las visitas, mira los subtítulos automáticos.

Cuánto cuesta

Lo que costó este vídeo

Vídeo, 14 s a 0,03 USD por minuto
0,0070 USD
Locución, tu propio MP3
0 USD
Total
0,0070 USD

Se cobra por segundo de vídeo. Un trabajo que falla no cuesta nada.

Límites

Lo que acepta una petición

Imágenes
De 1 a 100 por vídeo; el plugin manda 10 como mucho
Archivos de entrada
500 MB cada uno, 1 GB por trabajo
Espera del webhook
15 s por intento
Intentos del webhook
Hasta 6 en unas 7 h
Trabajos a la vez
3 por clave
Trabajos al día
500 por clave
Enlaces de salida
7 días

Cómo funciona

De la petición al archivo

  1. Crea la clave y el secreto

    En el panel de ReelSDK crea una clave rsdk_live_ con su secreto whsec_ y pégalos en wp-config.php.

  2. Copia el mu-plugin

    Guarda el archivo en wp-content/mu-plugins/: WordPress lo carga solo, sin activarlo.

  3. Añade la locución

    Sube el MP3 a la biblioteca de medios y pega su URL en el campo personalizado locucion_mp3 del inmueble.

  4. Publica el inmueble

    Cuando WP-Cron procesa el aviso, el vídeo aparece en la biblioteca de medios, adjunto al anuncio, con su ID en _reelsdk_video.

FAQ

Preguntas frecuentes

¿Necesito un plugin de pago?

No. Es un solo archivo PHP en wp-content/mu-plugins que usa funciones del núcleo de WordPress: wp_remote_post, register_rest_route y media_handle_sideload. Solo pagas los vídeos, a 0,03 USD por minuto.

¿Funciona con mi tema inmobiliario?

Sí, si cambias el tipo de entrada inmueble por el de tu tema y lees las fotos de donde las guarde. La API solo necesita URL públicas de las imágenes y del MP3.

¿Funciona en local o en una web con contraseña?

No del todo: ReelSDK tiene que poder descargar las fotos y el MP3 desde URL públicas y llegar a la ruta del webhook. Para probar, usa fotos ya publicadas y consulta el trabajo con GET /v1/jobs/{id}.

¿Qué pasa si mi web está caída cuando termina el vídeo?

ReelSDK hace hasta 6 intentos de aviso en unas 7 h. Si aun así no llega, el ID del trabajo está guardado en el inmueble y puedes pedirlo con GET /v1/jobs/{id} mientras duren los enlaces, 7 días.

¿Cuánto cuesta por inmueble?

Un vídeo de 5 fotos y 14 s como este cuesta menos de 0,007 USD, porque se paga por segundo de vídeo a 0,03 USD el minuto y la locución era un MP3 propio. Un trabajo que falla no cuesta nada.

¿Listo para empezar?

Genera vídeo desde tu app hoy

Tus primeros 0,50 USD son gratis y una sola clave sirve para todos los endpoints.