▶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.coAutenticacao
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.
POST /api/v1/files/upload-urlPUT upload_urlPOST /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
| Endpoint | Metodo | Descricao |
|---|---|---|
| /api/v1/transcriptions | POST | Upload de arquivos |
| /api/v1/transcriptions/youtube | POST | Link de vídeo |
| /api/v1/transcriptions | GET | Transcrições |
| /api/v1/transcriptions/{id} | GET | Editor de transcrição |
| /api/v1/transcriptions/{id}/status | GET | Status |
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
| Status | Transcricao |
|---|---|
| queued | Na fila |
| preprocessing | Pre-processando |
| processing | Processando |
| completed | Concluido |
| failed | Falhou |
Exportacoes
Depois de concluir, exporte transcricoes, legendas e dados estruturados em varios formatos.
| Exportar | Formato |
|---|---|
| Exportar | TXT |
| Exportar | SRT |
| Exportar | VTT |
| Exportar | JSON |
| Exportar | MD |
| Exportar | CSV |
| Exportar | DOCX |
| Exportar |
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.
| Idiomas | Codigo | Idiomas | Codigo | Idiomas | Codigo |
|---|---|---|---|---|---|
| Afrikaans | af | Gujarati (ગુજરાતી) | gu | Polish (Polski) | pl |
| Arabic (العربية) | ar | Hebrew (עברית) | he | Portuguese (Português) | pt |
| Azerbaijani (Azərbaycan) | az | Hindi (हिन्दी) | hi | Romanian (Română) | ro |
| Belarusian (Беларуская) | be | Croatian (Hrvatski) | hr | Russian (Русский) | ru |
| Bulgarian (Български) | bg | Haitian Creole (Kreyòl ayisyen) | ht | Slovak (Slovenčina) | sk |
| Bengali (বাংলা) | bn | Hungarian (Magyar) | hu | Slovenian (Slovenščina) | sl |
| Bosnian (Bosanski) | bs | Indonesian (Bahasa Indonesia) | id | Albanian (Shqip) | sq |
| Catalan (Català) | ca | Italian (Italiano) | it | Serbian (Српски) | sr |
| Czech (Čeština) | cs | Japanese (日本語) | ja | Swedish (Svenska) | sv |
| Welsh (Cymraeg) | cy | Kazakh (Қазақ) | kk | Swahili (Kiswahili) | sw |
| Danish (Dansk) | da | Kannada (ಕನ್ನಡ) | kn | Tamil (தமிழ்) | ta |
| German (Deutsch) | de | Korean (한국어) | ko | Telugu (తెలుగు) | te |
| Greek (Ελληνικά) | el | Lithuanian (Lietuvių) | lt | Thai (ไทย) | th |
| English | en | Latvian (Latviešu) | lv | Tagalog (Tagalog/Filipino) | tl |
| Spanish (Español) | es | Macedonian (Македонски) | mk | Turkish (Türkçe) | tr |
| Estonian (Eesti) | et | Malayalam (മലയാളം) | ml | Ukrainian (Українська) | uk |
| Basque (Euskara) | eu | Marathi (मराठी) | mr | Urdu (اردو) | ur |
| Persian (فارسی) | fa | Malay (Bahasa Melayu) | ms | Vietnamese (Tiếng Việt) | vi |
| Finnish (Suomi) | fi | Dutch (Nederlands) | nl | Chinese (Cantonese) (粵語) | yue |
| French (Français) | fr | Norwegian (Norsk) | no | Chinese (Simplified) (中文 简体) | zh |
| Galician (Galego) | gl | Punjabi (ਪੰਜਾਬੀ) | pa | Chinese (Taiwanese Mandarin) (國語) | zh_tw |