API de Transcripción

Envía medios para la transcripción por IA y la creación de proyectos. Admite archivos de Video y Audio.

POST/api/v1/transcribe

Implementación Rápida

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "file=@/path/to/your/video.mp4"

POSThttps://api.srtgen.com/api/v1/transcribe

Parámetros de Solicitud

Parámetro	Tipo	Requerido	Descripción
`file`	File	Yes	El archivo multimedia a transcribir (Multipart). Soportado: Video (mp4, mov, avi, webm, mkv), Audio (mp3, wav, m4a, flac). Máx. 2GB.
`videoUrl`	String	No*	URL externa del medio (requerido si no se proporciona el archivo en el cuerpo).
`name`	String	No	Nombre personalizado para el proyecto.
`languageCode`	String	No	Código de idioma de origen (ej. 'en-us'). Por defecto es 'auto' (detección automática) si se omite.
`filterProfanity`	Boolean	No	Si se deben auto-censurar las palabras explícitas. Por defecto es false.
`disfluencies`	Boolean	No	Si se deben incluir muletillas (ej. 'uh', 'um'). Por defecto es false.
`medicalMode`	Boolean	No	Transcripción optimizada para audio médico/sanitario. Por defecto es false.

Avanzado: URL + Ajustes de IA

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "videoUrl=https://example.com/medical_lecture.mp4" \
  -F "languageCode=en-us" \
  -F "filterProfanity=true" \
  -F "disfluencies=false" \
  -F "medicalMode=true"

POSThttps://api.srtgen.com/api/v1/transcribe

Respuesta Exitosa

Una solicitud exitosa devuelve un estado 200 OK con el proyecto y los detalles del trabajo en segundo plano.

projectIdEl identificador único de tu proyecto.
status'inProgress' (transcripción en curso).
Nota: Los créditos se calculan y deducen de tu saldo de forma asíncrona después de que finalice el proceso de transcripción.

{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "status": "inProgress"
}

Códigos de Error

Estado	Código de Error	Descripción
400	missing_file	No se encontró ningún archivo en el campo 'file' o 'video'.
400	unreachable_url	La videoUrl proporcionada no es accesible o devolvió un error.
400	invalid_parameter	Uno de los parámetros (ej. videoUrl) está mal formado.
400	file_read_failed	El archivo subido no pudo ser leído o está dañado.
401	unauthorized	La clave API falta o no es válida.
403	insufficient_balance	No tienes suficientes créditos para procesar la duración de este medio.
403	storage_quota_exceeded	El archivo excede la cuota de almacenamiento en la nube restante de tu plan.
413	payload_too_large	El archivo excede el límite absoluto de carga de 2GB del sistema.
500	transcription_failed	No se pudo iniciar el trabajo de transcripción (caída del proveedor de IA).
500	server_error	Algo salió mal, por favor inténtalo de nuevo más tarde.

Estructura de Respuesta de Error

{
  "success": false,
  "error": "insufficient_balance",
  "message": "Tu proyecto requiere 5 créditos, pero tu saldo es 2."
}

¿Fue útil esta página?

Transcribir

Parámetros de Solicitud

Respuesta Exitosa

Códigos de Error