Primo video

Leggi la skill all’indirizzo fluos://skill (il MCP video la serve tramite resources/read). Poi invia un primo job. Fluos crea e renderizza il video: il tuo agente gli dà il brief e ritira il risultato. Non chiamare la chat della dashboard.

Prompt del primo job

Usa Fluos come squadra video per questo compito. Realizza un teaser di lancio di 15 secondi in 9:16 con un hook d'apertura d'impatto, un titolo di prodotto in animazione cinetica e una schermata finale con una CTA chiara. Chiama create_video una sola volta, poi continua a chiamare wait_for_job con quel jobId finché non è pronto e condividi con me il playbackUrl. Per qualsiasi modifica, usa revise_video sullo stesso job invece di creare un nuovo video. Lascia che sia Fluos a fare il lavoro video; non provare a creare né a renderizzare video in locale.

Flusso

1. list_assets / upload_asset se il brief richiede filmati o un riferimento
2. create_video con un brief (recipe e format facoltativi). Passa projectId per creare in un progetto esistente; senza, Fluos ne crea uno
3. wait_for_job con quel jobId, ancora e ancora, fino a ready o failed (ogni chiamata attende fino a 45 secondi e una creazione richiede diversi minuti; nel frattempo non avviare un altro job). Una creazione terminata aspetta l’MP4 finale, quindi ready arriva con un playbackUrl da mostrare all’utente. Nel frattempo, gli host compatibili con MCP Apps mostrano una scheda del job in tempo reale con i passaggi, lo storyboard e l’anteprima live
4. revise_video con l’ultimo jobId per ogni modifica o nuovo tentativo: il job continua nello stesso progetto e nella stessa chat, così Fluos conserva il contesto del video. Usa di nuovo create_video solo per un video diverso. export_video → get_export per un altro formato o un download

Se il job è in awaiting_credits, la creazione ha esaurito i crediti ed è in pausa. Dai pause.topUpUrl all’utente e continua ad attendere. Lo stesso job riprende dopo una ricarica. Vedi Job in pausa.

Un solo job in corso per progetto: se ricevi JOB_STILL_RUNNING, c’è già un job in corso: usa wait_for_job su quello (trovalo con list_jobs), oppure cancel_job se l’utente vuole fermarlo.

È normale che create_video riesca e restituisca un jobId. I fallimenti compaiono più tardi in get_status con lo stato failed, non come errori del protocollo MCP. Vedi Errori.

Cosa passare a create_video

{
  brief: string;
  projectId?: string; // Omettilo per creare un progetto per questo video
  workspaceId?: string; // Dove crearlo; per impostazione predefinita, il tuo primo spazio di lavoro a pagamento
  recipe?: "generate" | "edit" | "compose" | "mix";
  assetIds?: string[];
  templateId?: string; // Da list_templates: crea in un nuovo progetto copiato dal modello
  brandKitId?: string; // Da list_brand_kits
  designSystem?: string; // Da list_brand_kits
  designMd?: string; // Un DESIGN.md inline solo per questo job
  style_reference_url?: string; // Link YouTube o .mp4/.mov/.webm diretto da cui adattare lo stile
  format?: {
    aspectRatio?: string;
    durationHintSeconds?: number;
    resolution?: string;
  };
}

Se ometti recipe, Fluos lo deduce dal brief e dagli elementi allegati. Vedi Ricette.

Caricamenti

Per usare una tua foto o i tuoi filmati, chiedi all’assistente di caricarli. Chiama upload_asset: Claude e gli altri host compatibili con MCP Apps mostrano un caricatore nella conversazione, e ogni host riceve un link di caricamento (valido per un’ora) da aprire nel browser. Una volta caricato il file, l’assistente lo ritrova con list_assets. I client in grado di inviare richieste HTTP possono inviare i byte con POST a uploadUrl e poi richiamare con storageId. Non inviare byte video grezzi nel corpo JSON-RPC.

Se ricevi ASSET_NOT_READY, attendi e riprova create_video.

Esportazione

export_video mette in coda un rendering in mp4, gif, webm, mov o png-sequence (format facoltativo, mp4 per impostazione predefinita). Controlla get_export finché il file non è pronto.

Le esportazioni pronte restituiscono un playbackUrl firmato. Gli host che supportano MCP Apps hanno anche un player integrato. Se il player non viene visualizzato, apri playbackUrl.

Dove si trova il lavoro

I job scrivono negli stessi spazi di lavoro, progetti, libreria ed esportazioni del sito web. Apri il progetto nella dashboard per vederne l’anteprima o continuare a modificarlo in chat.

Ti serve l’elenco completo degli strumenti? Vedi Strumenti.