Conteudo da API

Documentacao da Votxt OpenAPI

Beta A Votxt OpenAPI esta em beta. Teste integracoes em desenvolvimento antes de usar em producao.

Visao geral

A Votxt OpenAPI integra transcricao de audio e video em apps e fluxos de automacao.

Envie um arquivo ou use uma URL externa, crie uma tarefa de transcricao e acompanhe o status.

Depois de concluir, exporte transcricoes, legendas e dados estruturados em varios formatos.

URL base

https://api.votxt.co

Autenticacao

Envie a chave API no cabecalho da requisicao. O acesso API requer um plano ativo compativel.

X-API-Key: your_api_key_here
  • Abra as configuracoes da conta.
  • Confirme se seu plano inclui acesso API.
  • Crie uma chave API e guarde-a com seguranca.

Upload de arquivos

Use upload direto com URLs assinadas ou informe uma URL publica de arquivo externo.

  1. POST /api/v1/files/upload-url
  2. PUT upload_url
  3. 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
}

Transcricao

EndpointMetodoDescricao
/api/v1/transcriptionsPOSTUpload de arquivos
/api/v1/transcriptions/youtubePOSTLink de vídeo
/api/v1/transcriptionsGETTranscrições
/api/v1/transcriptions/{id}GETEditor de transcrição
/api/v1/transcriptions/{id}/statusGETStatus
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"
}

Status

StatusTranscricao
queuedNa fila
preprocessingPre-processando
processingProcessando
completedConcluido
failedFalhou

Exportacoes

Depois de concluir, exporte transcricoes, legendas e dados estruturados em varios formatos.

ExportarFormato
ExportarTXT
ExportarSRT
ExportarVTT
ExportarJSON
ExportarMD
ExportarCSV
ExportarDOCX
ExportarPDF

Formatos

  • Formatos de áudio: mp3, mpeg, mpga, m4a, wav, aac, ogg, opus, flac
  • Formatos de vídeo: mp4, webm, mov
  • Tamanho máximo do arquivo: Tamanho máximo: 5GB por arquivo

Idiomas

A Votxt oferece suporte a muitos idiomas de transcricao. Envie o codigo do idioma na requisicao.

IdiomasCodigoIdiomasCodigoIdiomasCodigo
AfrikaansafGujarati (ગુજરાતી)guPolish (Polski)pl
Arabic (العربية)arHebrew (עברית)hePortuguese (Português)pt
Azerbaijani (Azərbaycan)azHindi (हिन्दी)hiRomanian (Română)ro
Belarusian (Беларуская)beCroatian (Hrvatski)hrRussian (Русский)ru
Bulgarian (Български)bgHaitian Creole (Kreyòl ayisyen)htSlovak (Slovenčina)sk
Bengali (বাংলা)bnHungarian (Magyar)huSlovenian (Slovenščina)sl
Bosnian (Bosanski)bsIndonesian (Bahasa Indonesia)idAlbanian (Shqip)sq
Catalan (Català)caItalian (Italiano)itSerbian (Српски)sr
Czech (Čeština)csJapanese (日本語)jaSwedish (Svenska)sv
Welsh (Cymraeg)cyKazakh (Қазақ)kkSwahili (Kiswahili)sw
Danish (Dansk)daKannada (ಕನ್ನಡ)knTamil (தமிழ்)ta
German (Deutsch)deKorean (한국어)koTelugu (తెలుగు)te
Greek (Ελληνικά)elLithuanian (Lietuvių)ltThai (ไทย)th
EnglishenLatvian (Latviešu)lvTagalog (Tagalog/Filipino)tl
Spanish (Español)esMacedonian (Македонски)mkTurkish (Türkçe)tr
Estonian (Eesti)etMalayalam (മലയാളം)mlUkrainian (Українська)uk
Basque (Euskara)euMarathi (मराठी)mrUrdu (اردو)ur
Persian (فارسی)faMalay (Bahasa Melayu)msVietnamese (Tiếng Việt)vi
Finnish (Suomi)fiDutch (Nederlands)nlChinese (Cantonese) (粵語)yue
French (Français)frNorwegian (Norsk)noChinese (Simplified) (中文 简体)zh
Galician (Galego)glPunjabi (ਪੰਜਾਬੀ)paChinese (Taiwanese Mandarin) (國語)zh_tw

Suporte