Documentação da API
API de texto para voz (TTS) em português
Gere áudio com mais de 300 vozes naturais, legendas SRT sincronizadas e imagens com IA direto do seu código, do n8n ou de um agente de IA. API REST em JSON, autenticação por chave Bearer e processamento assíncrono: você envia, acompanha o status e baixa o resultado.
Primeiros passos
- Crie uma chave de API no app, em Configurações. A chave aparece uma vez só: guarde-a com segurança. Confira se ela funciona com Validar chave de API.
- Escolha a voz em Listar vozes (o campo
idApide cada voz) e envie o texto em Gerar áudio. - Acompanhe o status em Consultar TTS até
DONEe baixe o MP3 e a legenda SRT.
Autenticação
Base: https://darkvi.com/api. Envie a chave no cabeçalho Authorization em todas as chamadas — só a lista de vozes é pública. Chave ausente ou inválida responde 401.
Exemplo — gerar um áudio
curl -X POST "https://darkvi.com/api/tts" \
-H "Authorization: Bearer SUA_CHAVE_DE_API" \
-H "Content-Type: application/json" \
-d '{"text": "Olá! Este áudio foi gerado pela API.", "voice": "ID_API_DA_VOZ"}'Endpoints
TTS
- POSTGerar áudio
/api/ttsCria um texto para conversão em áudio e inicia o processamento. - GETBaixar áudio
/api/tts/audios/:idRetorna o MP3 gerado pelo TTS. - GETBaixar SRT
/api/tts/srt/:idGera o arquivo .srt (legenda) do áudio solicitado a partir dos dados de transcrição salvos no banco. - GETListar vozes
/api/tts/voicesRetorna a lista de vozes ativas disponíveis para TTS. - GETConsultar TTS
/api/tts/:idRetorna os dados do texto/áudio gerado (textSpeech) pelo ID. Só permite acesso ao dono do áudio.
SRT externo
- POSTEnviar áudio
/api/v1/srtEnvia um áudio externo e inicia a geração assíncrona da legenda SRT. Use o ID retornado para consultar o status. - GETConsultar SRT
/api/v1/srt/:idConsulta o estado de uma conversão de áudio externo pertencente ao usuário autenticado. - GETBaixar SRT externo
/api/v1/srt/:id/downloadBaixa o arquivo SRT depois que a tarefa atingir status DONE.
Imagens
- POSTGerar imagem
/api/v1/imagesCria um prompt de geração de imagem e inicia o processamento assíncrono. A geração é feita por um worker externo; use GET /api/v1/images/:id para acompanhar o status e obter a URL assinada quando status=DONE. - POSTUpload de imagem de referência
/api/v1/images/referenceFaz upload de uma imagem de referência para ser usada na geração. Retorna a 'key' que deve ser passada como referencePath no POST /api/v1/images. Requer plano pago ou ADMIN (plano 8 retorna 403). - GETConsultar imagem
/api/v1/images/:idRetorna o status e a URL assinada (quando DONE) de uma geração de imagem. Use em polling (recomendado: a cada 4s) até status=DONE para obter a url. - GETListar imagens
/api/v1/imagesRetorna a lista paginada de gerações de imagem do usuário autenticado, da mais recente para a mais antiga.
Para assistentes de IA
A referência também existe em texto puro, no padrão llms.txt. Em /llms.txt fica o resumo com os links; em /llms-full.txt, a documentação inteira em Markdown — cole num assistente de IA para ele escrever a integração para você.