API per video faceless per creare video da codice o Claude
Crea un video con una sola richiesta API, controlla l'avanzamento e scarica l'MP4 finito. Questa guida spiega il flusso delle richieste, il connettore per Claude e tre automazioni utili.
Creare un video dalla dashboard è semplice. Crearne trenta mette in luce ogni passaggio ripetitivo: apri il modulo, incolli l'argomento successivo, scegli le solite impostazioni, invii e torni più tardi a prendere il file. L'API per video faceless esiste per il momento in cui quella ripetizione diventa il lavoro vero e proprio.
Ci sono due modi per usarla. Chi sviluppa può chiamare direttamente l'API REST. Chi preferisce una conversazione può collegare Claude e chiedere i video in linguaggio naturale. Entrambi usano gli stessi formati, lo stesso saldo dell'account e la stessa libreria di video finiti dell'app principale.
Cosa abbiamo lanciato
- Un'API REST su /api/v1 per creare video, controllarne l'avanzamento, vedere in anteprima il costo in crediti, caricare file e gestire i lavori completati.
- Un connettore MCP per chiedere lo stesso lavoro da Claude, Claude Code, Cursor o un altro client compatibile.
- Accesso con il tuo account dall'app di Claude, senza copiare una chiave API personale nella chat.
- Chiavi API personali per le integrazioni via codice, da creare e revocare nelle Impostazioni.
Come funziona l'API
La creazione dei video è asincrona. Invia con POST un topic e un formatId a /api/v1/videos, e la risposta restituisce subito l'id del video e il costo in crediti. Usa quell'id per controllare l'avanzamento mentre il video viene prodotto. Quando lo stato diventa COMPLETED, la risposta include l'URL dell'MP4 finito.
- 1POST /api/v1/videos con { topic, formatId }: la risposta 202 include l'id del video e creditsCost.
- 2GET /api/v1/videos/{id} più o meno ogni minuto: lo stato passa da PENDING a PROCESSING e poi a RENDERING.
- 3Quando lo stato è COMPLETED, videoUrl è il tuo video finito. Scaricalo, pubblicalo o passalo alla fase successiva del tuo flusso di lavoro.
GET /api/v1/formats restituisce i formati disponibili e gli input che ognuno accetta, comprese le opzioni di durata, i campi specifici del formato e gli slot del cast per i video con personaggi. Puoi tenere i modelli predefiniti consigliati oppure scegliere i modelli per copione, voce, immagini, animazione e musica quando un flusso di lavoro richiede più controllo.
Creare video da Claude
Il connettore MCP è la strada senza codice. Aggiungi il connettore in Claude, accedi con il tuo account e descrivi il video che vuoi. Claude può elencare i formati adatti, mostrarti il costo in crediti, creare il video, controllarne l'avanzamento e restituirti il link finito nella conversazione.
“Fammi uno short di 60 secondi su cinque creature degli abissi che sembrano inventate, musica misteriosa, 1080p.”
Il connettore può anche elencare le voci, controllare il saldo, eliminare i video che non vuoi e caricare riferimenti dei personaggi o musica. Claude Code e Cursor usano una chiave API personale per gli stessi strumenti.
Tre ricette di automazione
1. Il canale da una lista di argomenti
Tieni le idee approvate in un foglio Google o in un database Notion. Un flusso pianificato su n8n o Zapier può leggere la riga successiva, creare il video, aspettare che sia pronto e mettere l'MP4 in una cartella di revisione. Tieni un passaggio di approvazione umana prima della pubblicazione: l'automazione è brava a spostare il lavoro, non a decidere se un video merita di essere pubblicato.
2. Il riutilizzo dei contenuti
Alcuni formati accettano un URL sorgente. Uno script può controllare il tuo feed RSS, passare l'URL di un nuovo articolo in formatInputs e creare da lì una bozza di video. Lo stesso schema funziona per newsletter e aggiornamenti di prodotto che sono tuoi. Rivedi il copione prima di pubblicare, soprattutto quando la fonte contiene citazioni, date o cifre che potrebbero aver bisogno di contesto.
3. Claude come produttore
Claude è utile quando il flusso di lavoro richiede ancora giudizio. Pianifica una settimana di argomenti in una conversazione, confronta formati e costi, poi crea i video uno alla volta. Puoi rivedere ogni risultato prima di decidere se l'argomento successivo merita lo stesso trattamento.
Prezzi e controllo dell'account
L'accesso all'API è incluso in ogni piano a pagamento, senza un abbonamento API separato. I video usano gli stessi prezzi in crediti della dashboard. Prima di crearne uno, chiama POST /api/v1/videos/preview-credits con il formato e le impostazioni che vuoi usare per vedere il costo esatto.
| Endpoint | Cosa fa |
|---|---|
| POST /videos | Crea un video da un argomento e restituisce id e costo esatto |
| GET /videos/{id} | Controlla lo stato e recupera l'MP4 finito |
| POST /videos/preview-credits | Costo esatto prima di creare |
| GET /formats, /models, /voices | Legge le opzioni di produzione disponibili |
| POST /assets/presign | Carica i tuoi riferimenti dei personaggi e la tua musica |
| GET /account | Piano e saldo crediti attuale |
Le chiavi personali si possono revocare dalle Impostazioni, e le connessioni con Claude si possono scollegare dall'account che le ha approvate. Il registro dei crediti mostra gli addebiti per ogni creazione e i rimborsi automatici dei rendering falliti.
Inizia in 5 minuti
- 1Apri le Impostazioni, vai su API e crea una chiave personale. Per Claude usa invece il flusso del connettore.
- 2GET /api/v1/formats per scegliere un formato, oppure parti da ai-images-short.
- 3Invia con POST il tuo primo argomento a /api/v1/videos e controlla finché non è COMPLETED.
- 4Usa il riferimento degli endpoint quando ti servono input opzionali, caricamenti o un esempio di richiesta da copiare e incollare.
Domande frequenti
No. L'accesso all'API è incluso in ogni piano a pagamento e usa gli stessi crediti della dashboard, agli stessi prezzi. Puoi vedere in anteprima il costo di qualsiasi video con POST /videos/preview-credits prima di crearlo.
Pubblica oggi il tuo primo video senza volto.
Scegli la nicchia, scegli i modelli, al video pensiamo noi. Dall'idea allo short finito in meno di 7 minuti, senza telecamera e senza montaggio.
Continua a leggere
Automazione YouTube faceless, il metodo reale nel 2026
Quasi tutte le guide sull'automazione faceless automatizzano la parte sbagliata e poi, senza che te ne accorga, affossano il canale. Ecco il metodo in 6 fasi e le due cose che non dovresti mai lasciare all'IA.
Automazione YouTube nel 2026, cosa fa guadagnare davvero
Quasi tutte le guide sull'automazione YouTube le scrive chi non ha mai pubblicato 100 video. Questa arriva da chi ne pubblica così tanti ogni mese, con i numeri che i guru saltano.
Miglior generatore video IA gratis 2026, 8 strumenti provati
Uno degli otto generatori video IA gratis che abbiamo testato ci ha fatto aspettare 47 minuti per esportare 45 secondi di video; un altro chiede 3,10 $ per un video che un concorrente consegna a 0,30 $. Ecco dove vince ogni strumento, dove ti costa un weekend senza che te ne accorga e quale si adatta al tuo modo di lavorare.