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.
Richiede il piano Pro o superiore. L'accesso all'API è incluso a partire da Pro. Crea una chiave nelle Impostazioni sviluppatore.
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 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 unmodel) - Elencare le voci —
GET /api/v1/voices(catalogo + le tue voci clonate e progettate) - Elencare i modelli —
GET /api/v1/models(VocalLab Studio / Pro / Lite) - Controllare lo stato / ottenere l'URL ospitato —
GET /api/v1/tts/:id - Controllare il tuo saldo —
GET /api/v1/pingoGET /api/v1/me
Scegliere un modello
Passa "model" in POST /api/v1/tts per scegliere il motore (predefinito v-pro):
v-studio— VocalLab Studio: il più recente, orientabile (segue le istruzioni di espressione), oltre 200 lingue.v-pro— VocalLab Pro: massima fedeltà, 15 lingue. Il predefinito.v-lite— VocalLab Lite: veloce ed economico — fatturato a metà dei punti.
La tua chiave API può usare tutti e tre. 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.