API de transcripción de Instagram para Reels

Añade la transcripción de videos de Instagram a un backend con un único endpoint REST asíncrono. Envía la URL de un Reel o video público, recibe una ubicación de consulta y recupera el texto estructurado de la transcripción con segmentos marcados en el tiempo.

Transcribe contenido de Instagram sin mantener un descargador

La importación de contenido de Instagram cambia con el tiempo y puede convertirse en una carga de mantenimiento. Fast Transcriber se encarga de resolver los enlaces públicos compatibles y del proceso de voz a texto mediante una única solicitud autenticada, para que tu aplicación pueda centrarse en la transcripción y en el flujo creado a su alrededor.

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

Reels: usa la URL instagram.com/reel/{shortcode} o instagram.com/reels/{shortcode} copiada de un Reel público.
Publicaciones con video: una URL instagram.com/p/{shortcode} funciona cuando la publicación contiene un solo video público; las publicaciones formadas únicamente por imágenes no tienen voz que transcribir.
Enlaces de video antiguos: los enlaces instagram.com/tv/{shortcode} se pueden enviar si el video sigue disponible públicamente.

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

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.instagram.com/reel/C0Example123/",
    "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 Instagram

Archivos de creadores: guarda texto que se pueda buscar junto a los Reels públicos que tu aplicación tiene autorización para indexar.
Revisión de contenido: envía afirmaciones habladas, mensajes de campaña o contenidos de creadores a un proceso de revisión basado en texto.
Reutilización de contenido: convierte la voz de videos aprobados en informes, subtítulos, citas o borradores, conservando las marcas de tiempo.

Enlaces compatibles y requisitos de acceso

La API admite URLs de Reels públicos de Instagram y de publicaciones con un solo video que el sistema pueda abrir sin una sesión de Instagram.

El Reel o la publicación con video debe ser público y estar disponible sin iniciar sesión.
Los perfiles privados, las publicaciones para mejores amigos, el contenido eliminado y los desafíos de inicio de sesión no se pueden importar mediante una URL.
La disponibilidad y los límites de solicitudes de Instagram pueden bloquear ocasionalmente incluso una URL pública; gestiona la tarea fallida y ofrece una alternativa de carga autorizada.
En las publicaciones en carrusel, usa una publicación directa con un solo video o carga el video específico que tienes autorización para procesar.

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 Instagram

Prueba el acceso sin iniciar sesión: abre el Reel o la publicación exacta en una ventana privada del navegador. Una pantalla de inicio de sesión suele significar que el sistema tampoco podrá recuperar el contenido.
Gestiona los carruseles de forma explícita: no des por hecho que la URL de una publicación selecciona todos los elementos. Si un carrusel contiene varios recursos, carga el video autorizado exacto.
Gestiona los fallos de acceso a la plataforma: un límite de solicitudes o un desafío de acceso de Instagram puede hacer que la tarea falle después de entrar en la cola. Espera antes de volver a intentarlo y ofrece una carga directa en lugar de reintentar indefinidamente.

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

¿Qué enlaces de Instagram puede transcribir la API?

Se pueden enviar como source_url las URLs de Reels públicos de Instagram y de publicaciones con un solo video que se abran sin iniciar sesión.

¿Puede la API transcribir contenido privado de Instagram?

No. Si tienes autorización para usar contenido privado, descárgalo mediante tu propio flujo autenticado y usa la API de carga directa.

¿La solicitud POST devuelve la transcripción terminada?

No. Devuelve 202 Accepted y un encabezado Location. Accepted significa que la tarea se puso en la cola, no que el contenido se haya recuperado; consulta esa URL hasta que la tarea termine o falle.