Visão Geral da API

A API do VocalLab permite gerar fala, listar vozes e consultar seu saldo de forma programática — a partir dos seus próprios aplicativos, scripts ou ferramentas de automação.

Assista ao tutorial completo · em inglês

Disponível em todos os planos, inclusive no Free. Cada chamada usa os pontos da sua conta (1 ponto a cada 15 caracteres). Crie uma chave no Studio, em API e MCP na barra lateral (ou na página Developer do vocallab.ai). (Licenças vitalícias do AppSumo: acesso completo a partir do Tier 3; o Tier 1 e o Tier 2 têm acesso limitado, com um limite de requisições mais baixo e requisições mais curtas.)

URL base

https://api.vocallab.ai

Autenticação

Envie sua chave de API como um token Bearer em cada requisição:

Authorization: Bearer vl_live_...

As chaves são criadas e revogadas no Studio, em API e MCP (ou na página Developer). Trate uma chave como uma senha — ela é exibida apenas uma vez, e qualquer pessoa que a tenha pode gastar seus pontos. Veja Chaves de API.

O que você pode fazer

• Gerar fala — POST /api/v1/tts (opcionalmente passe um model)
• Listar vozes — GET /api/v1/voices (catálogo + suas vozes clonadas e criadas)
• Listar modelos — GET /api/v1/models (VocalLab Studio / Studio Flash / Pro / Lite)
• Verificar status / obter a URL hospedada — GET /api/v1/tts/:id
• Baixar legendas SRT — GET /api/v1/tts/:id/captions (linhas de legenda ou palavra por palavra)
• Criar uma voz — POST /api/v1/voices/designs/previews e depois POST /api/v1/voices/designs para guardar
• Clonar uma voz — POST /api/v1/voices/clones (uma gravação curta, enviada em base64)
• Consultar seu saldo — GET /api/v1/ping ou GET /api/v1/me

Escolhendo um modelo

Passe "model" em POST /api/v1/tts para escolher o motor (padrão v-studio):

• v-studio — VocalLab Studio: o mais recente, direcionável (segue instruções de expressão), mais de 200 idiomas. O padrão.
• v-flash — VocalLab Studio Flash: os mesmos mais de 200 idiomas, cerca de 5× mais rápido, cobrado por ¾ dos pontos. Não direcionável.
• v-pro — VocalLab Pro: maior fidelidade, 15 idiomas.
• v-lite — VocalLab Lite: rápido e econômico — cobrado pela metade dos pontos.

Sua chave de API pode usar os quatro. Veja Modelos de Voz para detalhes.

Veja a Referência da API para todos os detalhes.

Cobrança

As gerações via API gastam do mesmo saldo de pontos do aplicativo web. O custo é calculado a partir do seu comprimento do texto, não da duração final do áudio:

• API: points = ⌈ characters ÷ 15 ⌉ — cerca de 15 caracteres por ponto.
• O aplicativo web cobra 17 caracteres por ponto, então a API tem um pequeno prêmio (~13%) pelo acesso programático.

O points_used é retornado em cada geração. Os pontos são medidos antes de a voz ser gerada, então você nunca pode gastar mais do que seu saldo — requisições sem pontos retornam 402. Como o áudio falado tem, em média, ~15–17 caracteres/segundo, 1 ponto ≈ 1 segundo de áudio é uma boa regra prática, mas a cobrança exata sempre segue a fórmula de caracteres acima.

Use dentro de ferramentas de IA

Prefere Claude, Cursor ou outro assistente de IA? O servidor MCP expõe as mesmas funcionalidades como ferramentas nativas — nada para instalar com a opção hospedada.