API de transcripción de TikTok: video a texto

Pon videos públicos de TikTok en la cola de transcripción desde una aplicación o servicio backend. Fast Transcriber acepta la URL del video, la procesa de forma asíncrona y devuelve texto estructurado y segmentos con marcas de tiempo.

Añade la conversión de TikTok a texto a un producto o flujo de contenido

En lugar de pedir a los usuarios que descarguen un TikTok público y vuelvan a cargarlo, envía directamente la URL compatible. La API asigna un ID a cada tarea y devuelve un formato predecible que puede pasar por colas, bases de datos, índices de búsqueda y sistemas de IA posteriores.

Elige la URL correcta de un video público de TikTok

Videos canónicos: prefiere tiktok.com/@creator/video/{id}, que identifica un solo video y facilita el registro y la eliminación de duplicados.
Enlaces cortos copiados: los enlaces compartidos de vm.tiktok.com y vt.tiktok.com se pueden enviar si su redirección todavía lleva a un video público.
Fuentes que no son videos: los perfiles de creadores, las páginas de hashtags, las páginas de búsqueda y las colecciones no identifican una única fuente de transcripción.

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

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.tiktok.com/@creator/video/1234567890123456789",
    "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 video público de TikTok

Contenido aprobado de creadores: convierte videos de campañas en texto que se pueda buscar para revisión e informes.
Investigación de tendencias: analiza el lenguaje hablado en un conjunto permitido de videos públicos sin transcribir cada clip manualmente.
Flujos de contenido accesible: usa los segmentos con marcas de tiempo como punto de partida para subtítulos y alternativas de texto revisadas por una persona.

Enlaces compatibles y requisitos de acceso

Envía la URL de un video público de TikTok que se pueda abrir sin iniciar sesión. El sistema obtiene el contenido antes de que empiece la transcripción.

El video debe ser público y seguir disponible en la URL enviada.
Los videos privados, solo para amigos, con restricción de edad, eliminados o protegidos por inicio de sesión no se pueden importar.
Envía un video por tarea de transcripción y respeta los derechos del creador y las reglas aplicables de la plataforma.

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 video público de TikTok

Comprueba la configuración de audiencia: una publicación privada o solo para amigos puede parecer válida para el creador que inició sesión, pero seguir siendo inaccesible para el sistema de transcripción.
Ten en cuenta las restricciones: las restricciones de edad, región o inicio de sesión pueden impedir la obtención del contenido aunque la URL esté bien formada.
Prevé fallos de videos eliminados: un video eliminado o moderado puede desaparecer entre el envío y el procesamiento, así que gestiona siempre un resultado fallido al consultar la tarea.

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

¿Funcionan los videos privados de TikTok?

No. La URL debe estar disponible públicamente sin iniciar sesión en TikTok.

¿Mi aplicación debe descargar primero el video de TikTok?

No si se trata de una URL pública compatible. Envíala directamente como source_url y Fast Transcriber se encargará de resolver el enlace.

¿Puede la API devolver marcas de tiempo?

Sí. Las tareas completadas incluyen texto de la transcripción y segmentos con marcas de tiempo, según los límites del plan de la cuenta autenticada.