Primeiro vídeo

Com o Fluos conectado, envie um briefing e siga o fluxo criar → consultar → exportar.

Leia a skill em fluos://skill (o Video MCP a serve em resources/read). Depois envie um primeiro job. O Fluos cria e renderiza o vídeo — o seu agente passa o briefing e recolhe o resultado. Não chame o chat do painel.

Prompt do primeiro job

Use Fluos as the video crew for this task. List my workspaces and projects, create a project if needed, then make a 15-second 9:16 launch teaser with a bold opening hook, kinetic product headline, and clear CTA endcard. Poll get_status until the preview is ready, then share the preview with me. Let Fluos do the video work; do not try to build or render video locally.

Fluxo

  1. list_workspaces → list_projects ou create_project
  2. list_assets / upload_asset se o briefing precisar de filmagens ou de uma referência
  3. create_video com um briefing (recipe e format opcionais)
  4. Consulte get_status a cada 5–8 segundos até ready ou failed
  5. revise_video para iterar, ou export_video → get_export para obter um arquivo

Um job em execução por projeto — se você receber JOB_STILL_RUNNING, consulte o status ou use cancel_job.

É esperado que create_video funcione e retorne um jobId. As falhas aparecem depois em get_status como failed, e não como erros de protocolo do MCP. Veja Erros.

O que passar em create_video

{
  projectId: string;
  brief: string;
  recipe?: "generate" | "edit" | "compose" | "mix";
  assetIds?: string[];
  format?: {
    aspectRatio?: string;
    durationHintSeconds?: number;
    resolution?: string;
  };
}

Se você omitir recipe, o Fluos classifica a partir do briefing e dos ativos anexados. Veja Receitas.

Envios

upload_asset tem duas etapas. A primeira chamada retorna uploadUrl. Faça um POST dos bytes e chame de novo com storageId. filename, mediaType e size são opcionais. Não envie bytes de vídeo brutos no corpo JSON-RPC.

Se você receber ASSET_NOT_READY, espere e tente create_video de novo.

Exportação

export_video enfileira uma renderização em mp4, gif, webm, mov ou png-sequence (format é opcional, o padrão é mp4). Consulte get_export até o arquivo ficar pronto.

As exportações prontas retornam um playbackUrl assinado. Hosts compatíveis com MCP Apps também recebem um player incorporado. Se o player não for exibido, abra o playbackUrl.

Onde o trabalho fica

Os jobs gravam nos mesmos espaços de trabalho, projetos, biblioteca e exportações do site. Abra o projeto no painel para ver a prévia ou continuar editando no chat.

Precisa da lista completa de ferramentas? Veja Ferramentas.