Riferimento degli strumenti
Raramente li chiami per nome: chiedi con parole semplici e il tuo assistente sceglie lo strumento. Strumenti che fanno spendere crediti a un video e restituiscono un job_id; il video viene visualizzato in background e get_job_status ti dice quando è pronto.
create_ad
Sezione intitolata “create_ad”Una pubblicità multi-scena da un brief, attraverso l’intera pipeline dello Studio: pianifica le scene e poi le renderizza.
| Input | ||
|---|---|---|
brief |
Richiesto | A cosa serve: prodotto, pubblico, angolo, atmosfera (3-2.000 caratteri). |
scene_count |
Opzionale | 2-6 scene, default 4. |
aspect |
Opzionale | 16:9 (predefinito), 9:16 per Reels, TikTok e Shorts, oppure 1:1. |
branded |
Opzionale | true applica il kit di marca salvato sul tuo account: logo, colori e scheda finale. Se non ne hai, la chiamata si interrompe prima di addebitare qualcosa. |
product_image_url |
Opzionale | Un’immagine pubblica del prodotto da mostrare. |
title, idempotency_key |
Opzionale |
Costi: 1 credito per il piano, poi il render. Se il rendering non può iniziare, il credito di pianificazione viene rimborsato. Prova: “Crea uno spot verticale di 4 scene per il nostro latte d’avena, caldo e comodo, con il mio brand.”
create_presenter_video
Sezione intitolata “create_presenter_video”Un presentatore legge il tuo copione alla telecamera. Costi: prezzati per lunghezza del copione, mostrati nella risposta come credits_charged.
| Input | ||
|---|---|---|
script |
Richiesto | Le parole esatte (5-2.000 caratteri). |
title, idempotency_key |
Opzionale |
Prova: “Crea un video per il presentatore che dica: Benvenuto nel team, ecco come prenotare il tuo primo turno.”
create_launch_video
Sezione intitolata “create_launch_video”Un breve promo per presentatori di un’app o prodotto; la sceneggiatura viene scritta per te e restituita con il lavoro. Costi: prezzati in base alla lunghezza della sceneggiatura.
| Input | ||
|---|---|---|
app_name, description |
Richiesto | Nome, cosa fa e per chi è. |
website_url, idempotency_key |
Opzionale |
Prova: “Realizza un video di lancio per Northwind, un’app di budgeting per freelance.”
get_job_status
Sezione intitolata “get_job_status”Gratis. Resi status (queued, processing, completed o failed), progress 0-100 e video_url una volta completati. I rendering di solito richiedono qualche minuto; un rendering fallito rimborsa quanto addebitato. Sono visibili solo i lavori sul tuo account.
get_account
Sezione intitolata “get_account”Gratis. Il tuo nome, email, piano e crediti rimanenti.