Panoramica API

L'API di VocalLab ti permette di generare audio vocale, elencare le voci e controllare il tuo saldo in modo programmatico — dalle tue app, dai tuoi script o dai tuoi strumenti di automazione.

Guarda il tutorial completo · in inglese

Disponibile in tutti i piani, anche in quello Free. Ogni chiamata consuma i punti del tuo account (1 punto ogni 15 caratteri). Crea una chiave in Studio da API e MCP nella barra laterale (oppure nella pagina Developer su vocallab.ai). (Licenze a vita AppSumo: accesso completo dal Tier 3 in su; il Tier 1 e il Tier 2 hanno un accesso limitato, con una frequenza di richieste più bassa e richieste più brevi.)

URL di base

https://api.vocallab.ai

Autenticazione

Invia la tua chiave API come token Bearer in ogni richiesta:

Authorization: Bearer vl_live_...

Le chiavi vengono create e revocate in Studio da API e MCP (oppure nella pagina Developer). Tratta una chiave come una password — viene mostrata una sola volta e chiunque la possieda può spendere i tuoi punti. Vedi Chiavi API.

Cosa puoi fare

• Generare audio vocale — POST /api/v1/tts (puoi opzionalmente passare un model)
• Elencare le voci — GET /api/v1/voices (catalogo + le tue voci clonate e progettate)
• Elencare i modelli — GET /api/v1/models (VocalLab Studio / Studio Flash / Pro / Lite)
• Controllare lo stato / ottenere l'URL ospitato — GET /api/v1/tts/:id
• Scaricare i sottotitoli SRT — GET /api/v1/tts/:id/captions (righe di sottotitolo o parola per parola)
• Progettare una voce — POST /api/v1/voices/designs/previews, poi POST /api/v1/voices/designs per conservarla
• Clonare una voce — POST /api/v1/voices/clones (una breve registrazione, inviata in base64)
• Controllare il tuo saldo — GET /api/v1/ping o GET /api/v1/me

Scegliere un modello

Passa "model" in POST /api/v1/tts per scegliere il motore (predefinito v-studio):

• v-studio — VocalLab Studio: il più recente, orientabile (segue le istruzioni di espressione), oltre 200 lingue. Il predefinito.
• v-flash — VocalLab Studio Flash: le stesse oltre 200 lingue, circa 5× più veloce, fatturato a ¾ dei punti. Non orientabile.
• v-pro — VocalLab Pro: massima fedeltà, 15 lingue.
• v-lite — VocalLab Lite: veloce ed economico — fatturato a metà dei punti.

La tua chiave API può usare tutti e quattro. Vedi Modelli vocali per i dettagli.

Vedi il Riferimento API per tutti i dettagli.

Fatturazione

Le generazioni tramite API spendono gli stessi punti dell'app web — 1 punto = 1 secondo di audio. L'API conteggia 15 caratteri al secondo (leggermente più dei 17 dell'app web). Non puoi mai spendere più del tuo saldo; le richieste senza punti sufficienti restituiscono 402.

Usala all'interno degli strumenti AI

Preferisci Claude, Cursor o un altro assistente AI? Il server MCP espone le stesse funzionalità come strumenti nativi — niente da installare con l'opzione ospitata.