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.

Plano Studio obrigatório. O acesso à API está incluído no Studio. Crie uma chave nas Configurações de desenvolvedor.

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 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 / Pro / Lite)
• Verificar status / obter a URL hospedada — GET /api/v1/tts/:id
• 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-pro):

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

Sua chave de API pode usar os três. 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 da chamada ao Inworld, 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.