API de Fast Transcriber

Crea tareas de transcripción para enlaces públicos o contenido multimedia cargado y recupera texto estructurado y segmentos con marcas de tiempo.

URL base

https://fast-transcriber.com/api/v1

El documento OpenAPI 3.1 legible por máquina está disponible en /api/v1/openapi.

Autenticación

Envía una clave de API activa de Fast Transcriber en el encabezado Authorization como token Bearer. El secreto completo se muestra una sola vez al crearla.

Authorization: Bearer ft_live_replace_me

Endpoints

Transcribir una URL

Proporciona exactamente un campo source_url. Los enlaces públicos compatibles usan el mismo proceso de resolución de enlaces que la función del navegador.

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.youtube.com/watch?v=example",
    "speaker_diarization": false
  }'

Una solicitud correcta devuelve 202 Accepted y un encabezado Location que contiene la URL que debes consultar.

Cargar un archivo

Primero solicita un destino prefirmado con el nombre exacto del archivo, el tamaño en bytes y el tipo MIME.

curl --request POST https://fast-transcriber.com/api/v1/uploads \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "filename": "interview.mp3",
    "content_type": "audio/mpeg",
    "size": 1234567
  }'

1. Envía los bytes al destino simple o multipart devuelto.
2. Guarda la clave y el proveedor de almacenamiento devueltos.
3. Pon una transcripción en la cola usando esa referencia de carga.

Antes de poner la tarea en la cola, el servidor verifica el propietario del objeto, el tamaño almacenado y el tipo de contenido. Se rechazan las claves creadas para otra cuenta.

Resultados

Consulta la URL de la tarea hasta que status sea completed o failed. Las tareas completadas incluyen texto y segmentos con marcas de tiempo.

{
  "data": {
    "id": "95c3fdd8-...",
    "filename": "interview.mp3",
    "status": "completed",
    "created_at": "2026-08-24T16:30:00.000Z",
    "duration_seconds": 1842,
    "text": "Completed transcript text...",
    "segments": []
  }
}

Errores

Todos los errores de la API usan una estructura estable que contiene un código y un mensaje.

{
  "error": {
    "code": "daily_limit_reached",
    "message": "You've reached your daily upload limit."
  }
}

Límites

Las tareas de la API comparten los límites del plan de la cuenta con el navegador. Las solicitudes de listado aceptan un parámetro limit entre 1 y 100, con un valor predeterminado de 25. La identificación de hablantes requiere el plan Pro.