▶Contenido de API

Documentacion de Votxt OpenAPI

Beta Votxt OpenAPI esta en beta. Prueba la integracion en desarrollo antes de usarla en produccion.

Resumen

Votxt OpenAPI permite integrar transcripcion de audio y video en aplicaciones y automatizaciones.

Sube un archivo o usa una URL externa, crea una tarea de transcripcion y consulta su estado.

Al finalizar, exporta transcripciones, subtitulos y datos estructurados en varios formatos.

URL base

https://api.votxt.co

Autenticacion

Envia la clave API en la cabecera de la solicitud. El acceso requiere un plan activo compatible con API.

X-API-Key: your_api_key_here

Abre la configuracion de tu cuenta.
Confirma que tu plan incluya acceso API.
Crea una clave API y guardala de forma segura.

Carga de archivos

Usa carga directa con URLs firmadas o proporciona una URL publica de archivo externo.

POST /api/v1/files/upload-url
PUT upload_url
POST /api/v1/transcriptions

POST /api/v1/files/upload-url
Content-Type: application/json
X-API-Key: your_api_key

{
  "filename": "audio.mp3",
  "file_size": 1048576,
  "upload_expires_in": 3600,
  "download_expires_in": 1800
}

Transcripcion

Endpoint	Metodo	Descripcion
/api/v1/transcriptions	POST	Carga de archivos
/api/v1/transcriptions/youtube	POST	Enlace de video
/api/v1/transcriptions	GET	Transcripciones
/api/v1/transcriptions/{id}	GET	Editor de transcripción
/api/v1/transcriptions/{id}/status	GET	Estado

POST /api/v1/transcriptions
Content-Type: application/json
X-API-Key: your_api_key

{
  "file_key": "12345-abc123def456.mp3",
  "filename": "audio.mp3",
  "language_code": "en",
  "transcription_type": "transcript",
  "enable_speaker_diarization": false,
  "webhook_url": "https://your-app.com/webhook"
}

Estado

Estado	Transcripcion
queued	En cola
preprocessing	Preprocesando
processing	Procesando
completed	Completado
failed	Error

Exportaciones