API de transcripción de Reels de Facebook

Convierte Reels y videos públicos de Facebook en texto desde tu backend. Envía la URL de Facebook, consulta la tarea asíncrona y usa la transcripción completada y sus segmentos con marcas de tiempo en tu aplicación.

Integra la transcripción de videos de Facebook en tus operaciones de publicación

Un video público de Facebook puede entrar en un flujo de revisión, archivo o accesibilidad mediante el mismo contrato de API que las demás fuentes compatibles. Tu sistema mantiene un solo modelo de autenticación y un solo esquema de transcripción, sin tener que mantener un servicio específico para Facebook.

Elige la URL correcta de un Reel o video público de Facebook

Reels: envía la URL facebook.com/reel/{id} copiada del Reel público.
Publicaciones con video: los enlaces públicos facebook.com/.../videos/{id} identifican videos normales de Facebook fuera de la sección de Reels.
Enlaces cortos compartidos: los enlaces fb.watch pueden funcionar si todavía redirigen a un video público que no requiere una cuenta.

Inicio rápido: pon en la cola una transcripción de un Reel o video público de Facebook

Crea una clave de API de Fast Transcriber y guárdala en una variable de entorno del servidor. Envía la URL pública del contenido multimedia como source_url; nunca expongas la clave Bearer en el código del navegador ni la subas al repositorio del código fuente.

curl --request POST https://fast-transcriber.com/api/v1/transcriptions \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "source_url": "https://www.facebook.com/reel/123456789012345",
    "speaker_diarization": false
  }'

Una solicitud válida devuelve 202 Accepted. Esto significa que la tarea se puso en la cola, no que la fuente se haya recuperado correctamente. Lee el encabezado de respuesta Location, asigna esa ruta a LOCATION_PATH y consúltala hasta que el estado de la tarea sea completed o failed.

LOCATION_PATH="/api/v1/transcriptions/95c3fdd8-..."
curl --request GET "https://fast-transcriber.com$LOCATION_PATH" \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN"

¿Todo listo para ejecutar esta solicitud? Crea una clave de API o consulta todos los endpoints en la documentación de la API.

Trabaja con texto y segmentos con marcas de tiempo

Las tareas completadas contienen el texto de la transcripción y los segmentos con marcas de tiempo disponibles según los límites del plan de la cuenta autenticada. El mismo formato de respuesta permite que una aplicación indexe un video, salte a los momentos citados, cree resúmenes o envíe la transcripción a una búsqueda autorizada o a un flujo RAG.

{
  "data": {
    "id": "95c3fdd8-...",
    "filename": "video-source.mp4",
    "status": "completed",
    "duration_seconds": 84,
    "text": "Texto completo de la transcripción...",
    "segments": [
      { "start": 0, "end": 3.8, "text": "Primer segmento..." }
    ]
  }
}

Establece speaker_diarization en true cuando necesites etiquetas de hablantes. La diarización requiere una cuenta Pro y usa los mismos límites que la aplicación web.

Qué crean los desarrolladores con transcripciones de un Reel o video público de Facebook

Archivos multimedia: permite buscar en colecciones autorizadas de videos públicos por las palabras pronunciadas en cada clip.
Revisión de campañas: convierte Reels y videos aprobados en texto para flujos de marca, jurídicos o de localización.
Operaciones de contenido: crea texto fuente alineado con el tiempo para resúmenes, clips y subtítulos revisados por una persona.

Enlaces compatibles y requisitos de acceso

El sistema acepta URLs compatibles de Reels y videos públicos de Facebook que se puedan ver sin una cuenta de Facebook.

El Reel o video debe ser público y estar disponible sin iniciar sesión.
Las publicaciones privadas, los grupos restringidos, el contenido eliminado y los videos protegidos por inicio de sesión no se pueden importar.
Si un video insertado está alojado en otra plataforma, envía la URL original del contenido compatible siempre que sea posible.

Si una grabación es privada y tienes autorización para procesarla, recupera el contenido multimedia mediante tu propio flujo autenticado y usa la API de carga directa de audio y video.

Soluciona problemas al importar un Reel o video público de Facebook

Distingue entre publicaciones y páginas públicas: una página pública no garantiza que todas sus publicaciones con video se puedan ver sin iniciar sesión. Prueba la URL exacta del video.
Evita URLs de grupos y feeds: las publicaciones de grupos restringidos, las páginas de feed y las URLs genéricas de perfiles no proporcionan una fuente de video que se pueda obtener públicamente.
Usa el alojamiento original: si una publicación de Facebook inserta un video externo, envía la URL de YouTube o la URL directa del contenido original.

Planifica el tratamiento de errores asíncronos

Las integraciones de producción deben gestionar fuentes no válidas o inaccesibles, fallos de autenticación, límites de la cuenta y fallos temporales de procesamiento. Los errores HTTP inmediatos usan una estructura {"error":{"code":"...","message":"..."}}. Una fuente puesta en la cola puede devolver después data.status como failed, con detalles en data.error, al consultar la tarea. No reintentes indefinidamente contenido privado, eliminado o protegido por inicio de sesión; muestra un mensaje claro u ofrece una alternativa de carga autorizada.

Preguntas frecuentes

¿La API admite tanto Reels como videos de Facebook?

Admite URLs compatibles de Reels y videos públicos de Facebook que se puedan abrir sin iniciar sesión.

¿Funcionan las publicaciones privadas o los videos de grupos restringidos?

No. El contenido debe estar disponible públicamente sin iniciar sesión en Facebook.

¿Puede la transcripción distinguir a los hablantes?

La diarización de hablantes está disponible con Pro al establecer speaker_diarization en true.