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
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.
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"
}'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();{
"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, antes de require_once ABSPATH . 'wp-settings.php';
define( 'REELSDK_KEY', 'rsdk_live_...' );
define( 'REELSDK_WEBHOOK_SECRET', 'whsec_...' );<?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
| Gancho o función | Cuándo se ejecuta | Qué hace |
|---|---|---|
transition_post_status | Al pasar el inmueble a publicado | Programa el trabajo con wp_schedule_single_event para que el editor no espere |
wp_remote_post | En la siguiente pasada de WP-Cron | Manda fotos y locución a POST /v1/slideshow?wait=0 con una Idempotency-Key por inmueble y contenido |
register_rest_route | Cuando ReelSDK avisa | Abre la ruta /wp-json/reelsdk/v1/webhook |
hash_hmac y hash_equals | Antes de aceptar el aviso | Comprueban la firma Reelsdk-Signature y descartan las de más de 300 s |
download_url y media_handle_sideload | En segundo plano, tras el aviso | Guardan 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
Crea la clave y el secreto
En el panel de ReelSDK crea una clave
rsdk_live_con su secretowhsec_y pégalos enwp-config.php.Copia el mu-plugin
Guarda el archivo en
wp-content/mu-plugins/: WordPress lo carga solo, sin activarlo.Añade la locución
Sube el MP3 a la biblioteca de medios y pega su URL en el campo personalizado
locucion_mp3del inmueble.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.
- WordPressPHP can't start ffmpeg where shell_exec is disabled, and wp_remote_post stops after 5 s. Render post videos with ReelSDK from a small must-use plugin: $0.03 per output minute, $0.50 free.
- Vídeos inmobiliariosConvierte las fotos horizontales de un anuncio en un vídeo vertical con locución, música y subtítulos, sin recortar ninguna foto.
- Vídeo con fotos y músicaConvierte unas fotos en un vídeo vertical con música, locución en español y subtítulos, a 0,03 USD por minuto de vídeo.
- Subtítulos automáticosEnvías la URL de un vídeo en español y recibes el MP4 con los subtítulos incrustados, más SRT, VTT y ASS, a 0,03 USD por minuto.
- Webhooks: delivery, signatures and retriesAdd webhook_url to any ReelSDK job and get the finished job POSTed to you, signed with HMAC-SHA256. Up to 6 attempts over about 7 hours, a 300 s signature window and tested verify code for Node, Deno and Python.
¿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.